blender/release/scripts/modules/bpy_extras/image_utils.py

# ##### BEGIN GPL LICENSE BLOCK #####
#
#  This program is free software; you can redistribute it and/or
#  modify it under the terms of the GNU General Public License
#  as published by the Free Software Foundation; either version 2
#  of the License, or (at your option) any later version.
#
#  This program is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
#
#  You should have received a copy of the GNU General Public License
#  along with this program; if not, write to the Free Software Foundation,
#  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
#
# ##### END GPL LICENSE BLOCK #####

# <pep8 compliant>

__all__ = (
    "image_load",
)


def image_load(filepath, dirpath, place_holder=False, recursive=False, convert_callback=None):
    import bpy
    import os

    try:
        return bpy.data.images.load(filepath)
    except RuntimeError:
        if place_holder:
            image = bpy.data.images.new(os.path.basename(filepath), 128, 128)
            # allow the path to be resolved later
            image.filepath = filepath
            return image