RENDERICON

C#: CWinCtrlRenderIcon

It is a control for the icon with using Render Texture.

It automatically cut out rectangle from the Render Texture area which you specify.

Multiple rendering result may be included within single Render Texture. After you render to the texture,it can render many icons at low cost.

For example ,it is effective to use that when you want to display the dress possible avatar icon on the listbox.

Like ICON , textures can also be rendered with it.

However, you should be careful with TEXTURE_ZOFFSET .

RENDERICON(Control name)

Property 1;

Property 2;

:

:

Property n

};

Note

Only one can be assigned to render.

Example

RENDERICON(Avatar) {
   ID = 000_000_00330;
   POSITION = -315,-22;
   TEX_ID = 255_000_00010;            //render texture id
   CONTENTS_SIZE = 1024,1024; //render texture size
   SIZE = 64,64;                              //display size
};

In this example, you can be sharing the 256( = 1024/64 x 1024/64) icon on a single texture. And it can be rendered by the single mesh. However, doing the sharing of more than 256 , it fails to allocate the area, and can’t render.

Property

Default value

COLOR = 1,1,1,1;
SE_ID = 0;

ID = Control ID

Define the control ID.

ID = 001_000_00010;

Note

If you don’t set the ID, it generates automatically from the hash value.

POSITION = X, Y

Determine the display position. The base position changes according to the anchor in STYLE.

POSITION = 32,{50} + 64;

Coordinates can be specified as a percentage .

TEX_ID = Texture ID

TEX_ID = Texture ID

Set the ID of the Render Texture.If you set the same ID as the other RENDERICON ,they share the same Render Texture.In this case, it is allocated by dividing the Render Texture to the icon size.

By setting this value to TEXTURE_ZOFFSET = Texture ID,Z offset , it is possible to control the rendering order .

A Render Texture size to be allocated is CONTENTS_SIZE.

Note

This property must always be set.

Note

Share the Render Texture only in the same window . Render Textures are not shared across a window.

Note

For each control, you can specify only one texture ID to render.

TEX_ID n = Texture ID,Part ID

TEX_ID n = Part ID

You set the texture ID and the part ID.

It can be set in the range of n = [1..7].

If n = 0, it operates the same texture as the TEX_ID.

If you specify a Part ID, it is not rendered, but is rendered as a regular texture.

CONTENTS_SIZE = Render Texture size,Render Texture size

Set the size of the Render Texture . It is necessary to set a common value between icons to share.

When you set a different value , there is no guarantee of behaviour.

Note

This property must always be set.

Set the same value between Render Texture that you want to share.

You can increase the compatibility if you note the following. the Render Texture size sets a power of two, sets square, and sets the less than or equal to 2048.

Note

It is possible to specify a percentage, but it is recommended to specify a straight value because of compatibility issues.

TEXTURE_OFFSET n = offset X,offset Y

Set the display offset of the badge.

It can be set in the range of n = [1..7].

Texture offset can be specified by a percentage .

SIZE = width,height

Set the display size.

And it is used to determine the allocation size from the Render Texture.

Error occurs when you set a different value between the share to that icon.

SIZE = 64,32; //64x32

Size can be specified as a percentage .

Note

This property must always be set.

Set the same value between Render Texture that you want to share.

COLOR = R,G,B,A

Set the color.

Set R, G, B in the range of 0…2 .

If you set a value in excess of one , each color component can double the brightness.

Set A in the range of 0…1 .

COLOR1 = R,G,B,A

Set the background color.

Set R, G, B, A between 0-1

SE_ID = SE_ID

To set the ID of the sound played when pressed . 0 is set as the default. This default value means not to play a sound.

STYLE = Flag0|Flag1|..|Flagn

You can set the display anchor of control.

Display position anchor flag	Description
ANCHOR_DEFAULT	Set the anchor position in the upper left Same as ANCHOR_LEFTTOP The default control center position is set to BASE_LEFT.
ANCHOR_LEFTTOP	Set the anchor position in the upper left The default control center position is set to BASE_LEFT.
ANCHOR_LEFT	Set the anchor position to the left. And vertical centering The default control center position is set to BASE_LEFT.
ANCHOR_LEFTBOTTOM	Set the anchor position to the left. Located along the lower edge The default control center position is set to BASE_LEFTBOTTOM.
ANCHOR_TOP	Set the anchor position to the upper side Centering at lateral. The default control center position is set to BASE_TOP.
ANCHOR_CENTER	Set the anchor position in the center of the window The default control center position is set to BASE_CENTER.
ANCHOR_BOTTOM	Set the anchor position at the bottom Centering at lateral. The default control center position is set to BASE_BOTTOM.
ANCHOR_RIGHTTOP	Set the anchor position in the upper right The default control center position is set to BASE_RIGHTBOTTOM.
ANCHOR_RIGHT	Set the anchor position to the right And vertical centering The default control center position is set to BASE_RIGHT.
ANCHOR_RIGHTBOTTOM	Set the anchor position to the right Located along the lower edge The default control center position is set to BASE_RIGHTBOTTOM.

You can set the center position of the control.

Base position change flag	Description
BASE_DEFAULT	It varies depending on the anchor flag . If you do not specifically set , this value is set . See the description of each anchor flag
BASE_LEFTTOP	Set the center position to the upper left side.
BASE_LEFT	Set the center position to the left side. and vertical centering.
BASE_LEFTBOTTOM	Set the center position to the bottom left side.
BASE_TOP	Set the center position to the upper side. and horizontal centering
BASE_CENTER	Set the center position to the center.
BASE_BOTTOM	Set the center position to the bottom side. And horizontal centering.
BASE_RIGHTTOP	Set the center position to the upper right side.
BASE_RIGHT	Set the center position to the right side. and horizontal centering
BASE_RIGHTBOTTOM	Set the center position to the bottom right side.

Style that limits the function as follows .

Function limit style	Description
HIDE	Hide.
DRAG	Enable a dragging.
DISABLE	It is not able to pressing the control. And the control color darken.
NOHIT	It is not able to pressing the control.