source: branches/testFACT++branch/dim/WebDID/ext-4.1.1a/resources/themes/stylesheets/neptune/default/mixins/_theme-background-image.scss

/**
 * Method which inserts a full background-image property for a theme image.
 * It checks if the file exists and if it doesn't, it'll throw an error. 
 * By default it will not include the background-image property if it is not found,
 * but this can be changed by changing the default value of $include-missing-images to 
 * be true. 
 */
@function theme-background-image($theme-name, $path, $without-url: false, $relative: false) {
    $exists_image: theme-image($theme-name, $path, true, false);
    
    @if $exists_image {
        $exists: theme_image_exists($exists_image);

        @if $exists == true {
            @return theme-image($theme-name, $path, $without-url, $relative);
        }
        @else {
//            @todo this needs to be smarter
//            @warn "@theme-background-image: Theme image not found: #{$exists_image}";

            @if $include-missing-images {
                @return theme-image($theme-name, $path, $without-url, $relative);
            }

            @return none;
        }
    }
    @else {
//        @todo this needs to be smarter...
//        @warn "@theme-background-image: No arguments passed";
    }
}