<?php
$app = \Concrete\Core\Support\Facade\Application::getFacadeApplication();
 
$boatImage = $item->getEntry()->getBoatImage();
 
if (is_object($boatImage)) {
    $imageHelper = $app->make('helper/image');
    // getThumbnail($fileObject, maxWidth, maxHeight, crop)
    // - maxWidth and maxHeight are integers - setting them to "9999" effectively means "no maximum size" for that particular dimension
    // - crop set to true will crop the image
    // - crop set to false will not crop the image and preserve its dimension ratio
 
    // getThumbnail() creates an image object with these properties
    // - src
    // - width
    // - height
 
    // Example:
    // the image will not have a maximum width or maximum height
    // the image will not be cropped
    // $thumbnail = $imageHelper->getThumbnail($fileObject, 9999, 9999, false);
    // Example:
    // the image will have a maximum width of 400px and a maximum height of 400px
    // the image will be cropped to 400px by 400px
    // $thumbnail = $imageHelper->getThumbnail($fileObject, 400, 400, true);
    // Example:
    // the image will have a maximum width of 300px and a maximum height that maintains the image proportions
    // the image will not be cropped
    // $thumbnail = $imageHelper->getThumbnail($fileObject, 300, 9999, false);
    // Example:
    // the image will have a maximum width of 300px and a maximum height of 300px, it will be resized to proportionately fit within the width and height
    // the image will not be cropped
    $thumbnail = $imageHelper->getThumbnail($fileObject, 300, 300, false);
 
    // HtmlObject\Image is part of the HTMLObject vendor library and is used to create the img element
    // concrete\vendor\anahkiasen\html-object\src\HtmlObject\Image.php
    $tag = new \HtmlObject\Image();
    $tag->src($thumbnail->src)
        ->width($thumbnail->width)
        ->height($thumbnail->height)
        ->addClass('my-image-class')
        // if there is no title, then the filename is used (the default title is the filename)
        ->alt($boatImage->getTitle());
 
    echo $tag;
}