* Get a preview by file path
*
* @param string $file Path of the file
- * @param int $x Width of the preview
- * @param int $y Height of the preview
- * @param bool $a Whether to not crop the preview
+ * @param int $x Width of the preview. A width of -1 will use the original image width.
+ * @param int $y Height of the preview. A height of -1 will use the original image height.
+ * @param bool $a Preserve the aspect ratio
* @param bool $forceIcon Force returning an icon
- * @param string $mode How to crop the image
+ * @param 'fill'|'cover' $mode How to crop the image
* @param bool $mimeFallback Whether to fallback to the mime icon if no preview is available
* @return FileDisplayResponse<Http::STATUS_OK, array{Content-Type: string}>|DataResponse<Http::STATUS_BAD_REQUEST|Http::STATUS_FORBIDDEN|Http::STATUS_NOT_FOUND, array<empty>, array{}>|RedirectResponse<Http::STATUS_SEE_OTHER, array{}>
*
* Get a preview by file ID
*
* @param int $fileId ID of the file
- * @param int $x Width of the preview
- * @param int $y Height of the preview
- * @param bool $a Whether to not crop the preview
+ * @param int $x Width of the preview. A width of -1 will use the original image width.
+ * @param int $y Height of the preview. A height of -1 will use the original image height.
+ * @param bool $a Preserve the aspect ratio
* @param bool $forceIcon Force returning an icon
- * @param string $mode How to crop the image
+ * @param 'fill'|'cover' $mode How to crop the image
* @param bool $mimeFallback Whether to fallback to the mime icon if no preview is available
* @return FileDisplayResponse<Http::STATUS_OK, array{Content-Type: string}>|DataResponse<Http::STATUS_BAD_REQUEST|Http::STATUS_FORBIDDEN|Http::STATUS_NOT_FOUND, array<empty>, array{}>|RedirectResponse<Http::STATUS_SEE_OTHER, array{}>
*
{
"name": "x",
"in": "query",
- "description": "Width of the preview",
+ "description": "Width of the preview. A width of -1 will use the original image width.",
"schema": {
"type": "integer",
"format": "int64",
{
"name": "y",
"in": "query",
- "description": "Height of the preview",
+ "description": "Height of the preview. A height of -1 will use the original image height.",
"schema": {
"type": "integer",
"format": "int64",
{
"name": "a",
"in": "query",
- "description": "Whether to not crop the preview",
+ "description": "Preserve the aspect ratio",
"schema": {
"type": "integer",
"default": 0,
"description": "How to crop the image",
"schema": {
"type": "string",
- "default": "fill"
+ "default": "fill",
+ "enum": [
+ "fill",
+ "cover"
+ ]
}
},
{
{
"name": "x",
"in": "query",
- "description": "Width of the preview",
+ "description": "Width of the preview. A width of -1 will use the original image width.",
"schema": {
"type": "integer",
"format": "int64",
{
"name": "y",
"in": "query",
- "description": "Height of the preview",
+ "description": "Height of the preview. A height of -1 will use the original image height.",
"schema": {
"type": "integer",
"format": "int64",
{
"name": "a",
"in": "query",
- "description": "Whether to not crop the preview",
+ "description": "Preserve the aspect ratio",
"schema": {
"type": "integer",
"default": 0,
"description": "How to crop the image",
"schema": {
"type": "string",
- "default": "fill"
+ "default": "fill",
+ "enum": [
+ "fill",
+ "cover"
+ ]
}
},
{