WIP: allow to load and use images on python scope #115543

Jaume Bellet · 2023-11-28T22:12:27+01:00

Jaume Bellet commented

2023-11-28 22:12:27 +01:00

First-time contributor

Allows use to load an image and use in a blender from python scope, without the need to load in bpy.data.images and hide it to users.

Adds functions under bpy.utils.images to allow script manage the images.

Adds a function to show the image on Layout.

Example python code

import os
import bpy
import bpy.utils.images

img = None

class ImageExamplePanel(bpy.types.Panel):
    """Creates a Panel in the Object properties window"""
    bl_label = "Image Example Panel"
    bl_idname = "OBJECT_PT_previews"
    bl_space_type = 'PROPERTIES'
    bl_region_type = 'WINDOW'
    bl_context = "object"

    def draw(self, context):
        row = self.layout.row()
        row.template_image_ui(image_value = img['id'], scale= 1)

def register():
    global img

    # Set path to an existing file
    path = os.path.join(os.path.dirname(bpy.app.binary_path), 'image.png')
    img = bpy.utils.images.load('my_image', path)

    bpy.utils.register_class(ImageExamplePanel)

def unregister():
    global img
    bpy.utils.unregister_class(ImageExamplePanel)
    bpy.utils.images.release(img['id'])

if __name__ == "__main__":
    register()

Allows use to load an image and use in a blender from python scope, without the need to load in bpy.data.images and hide it to users. Adds functions under bpy.utils.images to allow script manage the images. Adds a function to show the image on Layout. Example python code ``` import os import bpy import bpy.utils.images img = None class ImageExamplePanel(bpy.types.Panel): """Creates a Panel in the Object properties window""" bl_label = "Image Example Panel" bl_idname = "OBJECT_PT_previews" bl_space_type = 'PROPERTIES' bl_region_type = 'WINDOW' bl_context = "object" def draw(self, context): row = self.layout.row() row.template_image_ui(image_value = img['id'], scale= 1) def register(): global img # Set path to an existing file path = os.path.join(os.path.dirname(bpy.app.binary_path), 'image.png') img = bpy.utils.images.load('my_image', path) bpy.utils.register_class(ImageExamplePanel) def unregister(): global img bpy.utils.unregister_class(ImageExamplePanel) bpy.utils.images.release(img['id']) if __name__ == "__main__": register() ```

Jaume Bellet added 1 commit 2023-11-28 22:12:38 +01:00

fd014cbe37 Allows use to load an image and use in a blender from python scope, without the need to

load in bpy.data.images and hide it to users.

Adds functions under bpy.utils.images to allow script manage the images.

Adds a function to show the image on Layout.

Example python code

import os
import bpy
import bpy.utils.images

img = None

class ImageExamplePanel(bpy.types.Panel):
    """Creates a Panel in the Object properties window"""
    bl_label = "Image Example Panel"
    bl_idname = "OBJECT_PT_previews"
    bl_space_type = 'PROPERTIES'
    bl_region_type = 'WINDOW'
    bl_context = "object"

    def draw(self, context):
        row = self.layout.row()
        row.template_image_ui(image_value = img['id'], scale= 1)

def register():
    global img

    # Set path to an existing file
    path = os.path.join(os.path.dirname(bpy.app.binary_path), 'image.png')
    img = bpy.utils.images.load('my_image', path)

    bpy.utils.register_class(ImageExamplePanel)

def unregister():
    global img
    bpy.utils.unregister_class(ImageExamplePanel)
    bpy.utils.images.release(img['id'])

if __name__ == "__main__":
    register()

casey-bianco-davis added the

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

WIP: allow to load and use images on python scope #115543

Pull request closed