Yamyam: 1版をインポートしました

2018-06-28T19:40:50Z

1版をインポートしました

wiki>Ideasman42: /* Add the Icon Graphic */

2014-01-13T13:22:54Z

‎Add the Icon Graphic

新規ページ

= Understanding the needed files =

== The icon files ==

[[File:Blenderbuttons.png|center]]

In the ''release/datafiles/'' folder you can find Blender's icon files:

* <code>blender_icons.svg</code>
* <code>blender_icons16/*.dat</code>
* <code>blender_icons32/*.dat</code>

When opening the SVG file, make sure to use '''Inkscape'''. Other popular software such as Adobe Illustrator might not display all of the icons.
{{clr}}

== Groups of icons ==

As you see, icons are disposed in rows, which are grouped in a logical way and marked with the labels on the right.

== Icons names ==

Open <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_icons.h source/blender/editors/include/UI_icons.h]</code>

Apart from the GPL license and comments, you will find a big list starting with:

<source lang="c">
DEF_ICON(BLENDER)
DEF_ICON(QUESTION)
DEF_ICON(ERROR)
DEF_ICON(CANCEL)
DEF_ICON(TRIA_RIGHT)
</source>

As you can see in <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_resources.h source/blender/editors/include/UI_resources.h]</code>, the macro '''<code>DEF_ICON</code>''' is:

<source lang="c">
#define DEF_ICON(name) ICON_##name,
</source>

hence it takes the name in parentheses and defines ICON_<name-in-parentheses>

That is, in <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_icons.h source/blender/editors/include/UI_icons.h]</code> we define a list of names like
* <code>ICON_BLENDER</code>
* <code>ICON_QUESTION</code>
* <code>ICON_ERROR</code>
* <code>ICON_CANCEL</code>
* <code>ICON_TRIA_RIGHT</code>
* <code>...</code>

== Icons disposal ==

=== Using the "Icons" addons ===

Now to help you understand how this works, enable the [[Extensions:2.5/Py/Scripts/Development/Display_All_Icons|Icons addon]].

[[File:2.5-scripts-addons-system-display_all_icons.png|thumb|left|615px|Display All Icons panels]]

Go in the console space and in the view menu enable the icon viewer: you will get a nice list of icons to scrub in Console or in the Text Editor.

=== Icons order ===

[[File:Blenderbuttons-detail.png|frame|''blender_icons.svg'' file bottom-left detail]]

By scrolling the slider in the console header, you'll see that these icons appear:
# in the same order they are defined in <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_icons.h source/blender/editors/include/UI_icons.h]</code>.
# in the same order they are in the <code>blender_icons*</code> files.

Precisely:
* the first icon in the icons viewer (''ICON_QUESTION'') is the second icon at the bottom-left in the <code>blender_icons*</code> files,
* the second icon in the icons viewer (''ICON_ERROR'') is the third icon at the bottom-left in the <code>blender_icons*</code> files,
* and so on...

Their order is in rows, from left to right, and reading rows from the bottom to the top of the <code>blender_icons*</code> files.

{{Note|Note|For some reason, the first one is not available in Blender's buttons (will investigate).}}

=== Empty slots ===

You may have noticed that there are empty slots in the <code>blender_icons*</code> files, for example in the first line the slots '''16''' and '''17''', which are preceded by the ''MENU_PANEL'' icon and followed by the ''DOT'' icon.

These empty slots have a correspondant code in <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_icons.h source/blender/editors/include/UI_icons.h]</code> as shown below:

<source lang="c">
DEF_ICON(MENU_PANEL)
#ifndef DEF_ICON_BLANK_SKIP
DEF_ICON(BLANK002)
DEF_ICON(BLANK003)
#endif
DEF_ICON(DOT)
</source>

= Adding an icon =

== Add the icon image ==

Find an empty slot where to put your icon in the <code>blender_icons*</code> files, putting it in the right group.

Add the icon in the image, for example the first free slot, number '''16'''.

This corresponds to '''<code>DEF_ICON(BLANK002)</code>''' in the source code.

== Add your icon name ==

Choose a name which won't clash with existing names, for example '''<code>MYICON</code>'''.

In <code>[http://git.blender.org/gitweb/gitweb.cgi/blender.git/blob_plain/HEAD:/source/blender/editors/include/UI_icons.h source/blender/editors/include/UI_icons.h]</code>:
* move '''<code>DEF_ICON(BLANK002)</code>''' correspondant to the blank slot you have chosen out of the '''<code>#ifndef</code>'''
* change it to '''<code>DEF_ICON(MYICON)</code>'''

Like this:

<source lang="c">
DEF_ICON(MENU_PANEL)
DEF_ICON(MYICON)
#ifndef DEF_ICON_BLANK_SKIP
DEF_ICON(BLANK003)
#endif
DEF_ICON(DOT)
</source>

== Add the Icon Graphic ==

For testing you can edit <tt>blender_icons16.png/blender_icons32.png</tt>,<br>but if you want this to make its way back into Blender you should edit the SVG source: <tt>blender_icons.svg</tt>

Once you have done this you can re-generate the images by running inkscape from the command-line:
<source lang="bash">
python3 blender_icons_update.py
</source>

On Unix systems you can simply run:
<source lang="bash">
make icons
</source>

''Note that both inkscape and blender must be in the system PATH for this command to execute properly.''

== Compile! ==

Finally, compiling blender you should see your icon '''<code>MYICON</code>''' in Blender!
Enable the Icon addon again and search for it at number '''16'''.

= See also =

* [[Extensions:2.5/Py/Scripts/Development/Display_All_Icons|Icons script's wiki page]]
* [http://projects.blender.org/tracker/index.php?func=detail&aid=22011 Icon script's tracker page]

← 古い版	2018年6月28日 (木) 19:40時点における版
(相違点なし)

Dev:2.5/Doc/How to/Add an icon - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Ideasman42: /* Add the Icon Graphic */

Yamyam: 1版をインポートしました