https://wiki.blender.jp/index.php?action=history&feed=atom&title=%E5%88%A9%E7%94%A8%E8%80%85%3ABrita%2FProposals%2FUIPreviews 2026-04-30T01:40:49Z このウィキのこのページに関する変更履歴 MediaWiki 1.31.0 https://wiki.blender.jp/index.php?title=%E5%88%A9%E7%94%A8%E8%80%85:Brita/Proposals/UIPreviews&diff=149681&oldid=prev 2018-06-28T21:13:54Z

<p>1版 をインポートしました</p> <table class="diff diff-contentalign-left" data-mw="interface"> <tr class="diff-title" lang="ja"> <td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← 古い版</td> <td colspan="1" style="background-color: #fff; color: #222; text-align: center;">2018年6月28日 (木) 21:13時点における版</td> </tr><tr><td colspan="2" class="diff-notice" lang="ja"><div class="mw-diff-empty">(相違点なし)</div> </td></tr></table>

Yamyam https://wiki.blender.jp/index.php?title=%E5%88%A9%E7%94%A8%E8%80%85:Brita/Proposals/UIPreviews&diff=149680&oldid=prev 2017-03-20T18:03:37Z

<p></p> <p><b>新規ページ</b></p><div>=UI Previews - Proposal=<br /> <br /> UI previews is an addition to the blender python API that allows requesting of image previews from files and the displaying of said previews in the UI as custom icons.<br /> <br /> It is now possible to load single image or a set of previews for use in the UI with the existing widgets. It is not possible to override the default icons or share icons between addons.<br /> <br /> Displaying previews in Blender's UI and requesting those previews is a stepping stone for the asset-experiments and engine projects.<br /> <br /> <br /> ==UI Examples==<br /> A preview can be used as a custom icon in any place an icon can be used.<br /> Examples:<br /> [[File:Rl-ui_previews_button.png|thumb|left|button with label]]<br /> [[File:Rl-ui_previews_button_no_label.png|thumb|left|no label]]<br /> [[File:Rl-ui_previews_menu_item.png|thumb|left|menu item]]<br /> &lt;div style=&quot;clear: both&quot;&gt;&lt;/div&gt;<br /> <br /> Sample UI script:<br /> [https://developer.blender.org/diffusion/B/browse/master/release/scripts/templates_py/ui_previews_custom_icon.py scripts/templates_py/ui_previews_custom_icon.py]<br /> <br /> Furthermore, an EnumProperty with custom icons can be built and displayed in the appropriate templates.<br /> Examples:<br /> [[File:Rl-ui_previews_prop.png|thumb|left|164px|prop]]<br /> [[File:Rl-ui_previews_iconview.png|thumb|left|546px|template_icon_view]]<br /> &lt;div style=&quot;clear: both&quot;&gt;&lt;/div&gt;<br /> <br /> Sample UI script:<br /> [https://developer.blender.org/diffusion/B/browse/master/release/scripts/templates_py/ui_previews_dynamic_enum.py scripts/templates_py/ui_previews_dynamic_enum.py]<br /> <br /> <br /> ==Use Cases==<br /> <br /> * custom icon for buttons or menu items representing:<br /> ** an action not available in Blender's default icons<br /> &lt;!--** custom branding of a 3rd party (eg. external render engine logo)--&gt;<br /> <br /> * set of file previews for picking image, movie, font and blend files integrated in the UI<br /> * set of previews representing presets or that otherwise illustrate the results of a choice<br /> <br /> <br /> <br /> ==The big picture==<br /> * This system allows thumbnail images to be used in the UI, as preview image or as an icon.<br /> * These preview images are in a dynamic cache, which can be deleted or refreshed at any time. <br /> * For that reason addons or UI scripts that rely on the feature have to carefully manage this, to not overload Blender with preview loading time.<br /> <br /> <br /> ==Design specs - if you want to use this in a release==<br /> <br /> * Do not use this for advertising, logos or other non-functional use cases.<br /> * Use a minimum of custom icons. This helps uncluttering the interface and keeping Blender's interface uniform.<br /> * Only use these images in a way that is compatible with how rest of Blender works - as if it's a default interface we provide for everyone.<br /> * Only use the feature within the context and UI of your own Add-on. You cannot rely on other add-ons to have this already preloaded. This feature also does not allow replacing of the default icons.<br /> * Do not force preview image creation outside of the add-on dir, except when explicitly asked for by the user in the UI.<br /> * Use the previews via &quot;lazy loading&quot; - create on first use, not on start of Blender.<br /> * The default icon size in Blender is 32x32 and for previews 256x256. Your images will be scaled to fit these sizes on their maximum side.<br /> <br /> ==How things work internally==<br /> * previews of files can be requested via python<br /> * Blender generates a PreviewImage and populates the image data using the existing thumbnailing capacities ('IMAGE', 'MOVIE', 'BLEND', 'FONT')<br /> <br /> * the PreviewImage is used as a source for BKE_icon by being placed in the 'obj' field of Icon<br /> * PreviewImages have an icon_id which can be used in UI functions as the icon_value<br /> <br /> * if a preview is requested from a file already thumbnailed, the cache is used if possible<br /> * previews are accessed in python through 'preview collections': dict like wrappers that hold previews and are extendable<br /> * previews are internally stored in a GHash 'gCachedPreviews' using the collection and filename as hash value<br /> * if an already existing preview is requested (same collection+filename) it is simply retrieved, having however the option to force reload<br /> * previews are freed when the collection they belong to is deleted<br /> * addons should delete collections they create in unregister()<br /> * addons can also free their previews on pre/post loading blend files<br /> * preview collections are created and deleted via bpy.utils.previews<br /> <br /> * PreviewImages are not IDs, they are generated and never saved with blend files</div>

wiki>Brita