diff options
author | Campbell Barton <ideasman42@gmail.com> | 2012-03-09 22:28:30 +0400 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2012-03-09 22:28:30 +0400 |
commit | 89a963fb7fdff543b77de790355b9dac3019bd33 (patch) | |
tree | 4e1d2245e20f8c21625e99d771776f66c233a0de /source/blender/windowmanager/intern/wm_cursors.c | |
parent | de4bd55e01bc574c13977537ace1a0901dcfcaf0 (diff) |
style cleanup: comment blocks
Diffstat (limited to 'source/blender/windowmanager/intern/wm_cursors.c')
-rw-r--r-- | source/blender/windowmanager/intern/wm_cursors.c | 72 |
1 files changed, 36 insertions, 36 deletions
diff --git a/source/blender/windowmanager/intern/wm_cursors.c b/source/blender/windowmanager/intern/wm_cursors.c index 0770faa8d47..e35a1a269ae 100644 --- a/source/blender/windowmanager/intern/wm_cursors.c +++ b/source/blender/windowmanager/intern/wm_cursors.c @@ -273,44 +273,44 @@ void WM_timecursor(wmWindow *win, int nr) } -/* ****************************************************************** -Custom Cursor Description: - -Each bit represents a pixel, so 1 byte = 8 pixels, -the bytes go Left to Right. Top to bottom -the bits in a byte go right to left -(ie; 0x01, 0x80 represents a line of 16 pix with the first and last pix set.) - -A 0 in the bitmap = bg_color, a 1 fg_color -a 0 in the mask = transparent pix. - -Until 32x32 cursors are supported on all platforms, the size of the -small cursors MUST be 16x16. - -Large cursors have a MAXSIZE of 32x32. - -Other than that, the specified size of the cursors is just a guideline, -However, the char array that defines the BM and MASK must be byte aligned. -ie a 17x17 cursor needs 3 bytes (cols) * 17 bytes (rows) -(3 bytes = 17 bits rounded up to nearest whole byte). Pad extra bits -in mask with 0's. - -Setting big_bm=NULL disables the large version of the cursor. - -******************************************************************* - -There is a nice Python GUI utility that can be used for drawing cursors in -this format in the Blender source distribution, in -blender/source/tools/MakeCursor.py . Start it with $ python MakeCursor.py -It will copy its output to the console when you press 'Do it'. - -*/ +/* ****************************************************************** + * Custom Cursor Description: + * + * Each bit represents a pixel, so 1 byte = 8 pixels, + * the bytes go Left to Right. Top to bottom + * the bits in a byte go right to left + * (ie; 0x01, 0x80 represents a line of 16 pix with the first and last pix set.) + * + * A 0 in the bitmap = bg_color, a 1 fg_color + * a 0 in the mask = transparent pix. + * + * Until 32x32 cursors are supported on all platforms, the size of the + * small cursors MUST be 16x16. + * + * Large cursors have a MAXSIZE of 32x32. + * + * Other than that, the specified size of the cursors is just a guideline, + * However, the char array that defines the BM and MASK must be byte aligned. + * ie a 17x17 cursor needs 3 bytes (cols) * 17 bytes (rows) + * (3 bytes = 17 bits rounded up to nearest whole byte). Pad extra bits + * in mask with 0's. + * + * Setting big_bm=NULL disables the large version of the cursor. + * + * ******************************************************************* + * + * There is a nice Python GUI utility that can be used for drawing cursors in + * this format in the Blender source distribution, in + * blender/source/tools/MakeCursor.py . Start it with $ python MakeCursor.py + * It will copy its output to the console when you press 'Do it'. + * + */ /* Because defining a cursor mixes declarations and executable code -each cursor needs it's own scoping block or it would be split up -over several hundred lines of code. To enforce/document this better -I define 2 pretty braindead macros so it's obvious what the extra "[]" -are for */ + * each cursor needs it's own scoping block or it would be split up + * over several hundred lines of code. To enforce/document this better + * I define 2 pretty braindead macros so it's obvious what the extra "[]" + * are for */ #define BEGIN_CURSOR_BLOCK { #define END_CURSOR_BLOCK } |