<?php

/**
 * @package    Grav\Common\Media
 *
 * @copyright  Copyright (c) 2015 - 2025 Trilby Media, LLC. All rights reserved.
 * @license    MIT License; see LICENSE file for details.
 */

namespace Grav\Common\Media\Interfaces;

/**
 * Class implements media file interface.
 */
interface MediaFileInterface extends MediaObjectInterface
{
    /**
     * Check if this medium exists or not
     *
     * @return bool
     */
    public function exists();

    /**
     * Get file modification time for the medium.
     *
     * @return int|null
     */
    public function modified();

    /**
     * Get size of the medium.
     *
     * @return int
     */
    public function size();

    /**
     * Return the path to file.
     *
     * @param bool $reset
     * @return string path to file
     */
    public function path($reset = true);

    /**
     * Return the relative path to file
     *
     * @param bool $reset
     * @return mixed
     */
    public function relativePath($reset = true);
}