b-init / ImagePaste

A simple Blender addon to grab images from your clipboard and paste as a reference image in viewport or onto the image editor.
GNU General Public License v3.0
251 stars 9 forks source link

ImagePaste

A simple Blender add-on to paste images from the clipboard to various places in Blender and copy them to the clipboard to be pasted anywhere. Works with Blender 2.80 and above.

This Addon is soon to be deprecated as the functionality is being integrated into Blender itself!

Installing

  1. Download the latest release (you can also view the changelog on the release page).
  2. Go to Edit|Preferences. On the Add-ons tab, choose Install and select the downloaded .zip file.
  3. Tick the box beside the add-on name.

Using

demo

The add-on supports copying images to the clipboard and pasting them from various places:

Image Editor

Image Editor

Copy Image:

Paste as Images:

Video Sequencer

Video Sequencer

Paste as Image Strips:

Shader Editor

Shader Editor

Paste as Image Textures:

3D Viewport

3D Viewport

Paste as Planes:

Paste as References:

Configuring

Customizing the save folder

By default, pasted images will be stored in a temporary folder, this one will be deleted when you close Blender. If you want, you can redirect these images to a different directory. Preferences - directory

On the other hand, after you save the .blend file, these pasted images will be saved where the .blend file is located - in the ImagePaste folder. This folder can also be customized in the preferences. Preferences - subdirectory

Customizing the image filename

Preferences - filename

You can customize the filename of the pasted image with the help of some predefined variables:

Variable Description Example
${addonName} Name of the add-on ImagePaste
${yearLong} Year with the century 2021, 2022, …
${yearShort} Year without the century 21, 22, …
${monthNumber} Month as a zero-padded decimal number 01, 02, …, 12
${monthNameLong} Full month name January, February, …, December
${monthNameShort} Abbreviated month name Jan, Feb, …, Dec
${day} Day of the month as a zero-padded decimal number 01, 02, …, 31
${weekdayNumber} Weekday as a decimal number 0, 1, …, 6
${weekdayNameLong} Full weekday name Sunday, Monday, …, Saturday
${weekdayNameShort} Abbreviated weekday name Sun, Mon, …, Sat
${hour24} Hour (24-hour clock) as a zero-padded decimal number 00, 01, …, 23
${hour12} Hour (12-hour clock) as a zero-padded decimal number 01, 02, …, 12
${minute} Minute as a zero-padded decimal number 00, 01, …, 59
${second} Second as a zero-padded decimal number 00, 01, …, 59
${index} Order of the image 1, 2, …
${index:N} N-digits image order number with zero padding ${index:2} gives 01, 02, …

The default filename is ${addonName}-${yearShort}${monthNumber}${day}-${hour24}${minute}${second}.

Choosing the image type to move when saving the file

Preferences - image type

This feature will move (actually copy) images into the save directory after you save the file, so you can paste images anytime, no need to save it first. There's also an option in the add-on preferences you can choose the type of images to move:

Troubleshooting

If ImagePaste doesn't work, try:

Contributing and getting support

This is only a small project and we're happy to know it helped some of you. I just want to say that all this wouldn't have been possible without these great contributors and everybody who comes with new ideas and bug reports! So thank you all!

It will be great if you have an idea and turn it into visible. Tell us how amazing they are by suggesting a feature, or you can make it yourself by creating a pull request. And if you encounter a problem, let us know by opening an issue. But before doing anything, let's take a look at our contributing guide, it will show you how to start with all of that.