# Filename

The `Filename` class handles complex mapping of file attributes (i.e for thumbnails) into human readable filenames.

****

- Full class name: `Kirby\Filesystem\Filename`
- Alias: `Kirby\cms\filename`
- Source: <https://github.com/getkirby/kirby/tree/5.5.3/src/Filesystem/Filename.php#L31>

****

### Filename

- [new Filename()](https://getkirby.com/docs/reference/objects/filesystem/filename/__construct.md)
- [$filename->__toString()](https://getkirby.com/docs/reference/objects/filesystem/filename/__to-string.md)
- [$filename->attributesToArray()](https://getkirby.com/docs/reference/objects/filesystem/filename/attributes-to-array.md)
- [$filename->attributesToString()](https://getkirby.com/docs/reference/objects/filesystem/filename/attributes-to-string.md)
- [$filename->blur()](https://getkirby.com/docs/reference/objects/filesystem/filename/blur.md)
- [$filename->crop()](https://getkirby.com/docs/reference/objects/filesystem/filename/crop.md)
- [$filename->dimensions()](https://getkirby.com/docs/reference/objects/filesystem/filename/dimensions.md)
- [$filename->extension()](https://getkirby.com/docs/reference/objects/filesystem/filename/extension.md)
- [$filename->grayscale()](https://getkirby.com/docs/reference/objects/filesystem/filename/grayscale.md)
- [$filename->name()](https://getkirby.com/docs/reference/objects/filesystem/filename/name.md)
- [$filename->quality()](https://getkirby.com/docs/reference/objects/filesystem/filename/quality.md)
- [$filename->sharpen()](https://getkirby.com/docs/reference/objects/filesystem/filename/sharpen.md)
- [$filename->toString()](https://getkirby.com/docs/reference/objects/filesystem/filename/to-string.md)

## Examples

```php
$filename = new Filename('some-file.jpg', '{{ name }}-{{ attributes }}.{{ extension }}', [
  'crop'    => 'top left',
  'width'   => 300,
  'height'  => 200
  'quality' => 80
]);