[AD] A few minor changes to the docs

[ Thread Index | Date Index | More lists.liballeg.org/allegro-developers Archives ]


Here are some suggestions for changes to the Allegro docs.


+ In the "Windows specifics" section, it mentions that in order to use a
custom application icon, the executable must contain an icon called "allegro
icon". What the docs do not mention is how to create one using MSVC. Here's
how this would be done.
Go to the "insert" menu and select "resource". In the dialog that comes up,
select "icon" from the "Resource types" list and press "New". The new icon
will be opened in a window, and in the workspace window, the newly-created
icon will be listed in the 'icon' folder of the resources tree-control.
Right click the icon in the workspace window and select "properties". In the
ID field, enter "allegro_icon" (note: you MUST include the quotes ("'s) as
well). The compiled program will now use this icon as it's icon (the icon
that appears in the program's entry in the taskbar and as it's icon in the
top-left corner of it's window). The exe file will also use it as it's icon
unless it is already using another icon that was added earlier. Double
clicking the icon in the workspace window will open it up and allow it to be
edited.


+ In the docs for set_color_depth(), it's "see also" section should point to
"bitmap_color_depth()" so that the current colour depth can be found.


+ In the docs for bitmap_color_depth(), it should mention that you can pass
in 'screen' as the bitmap paramater to get the colour-depth of the currently
used graphics-mode.



I have also optimised the hsv_to_rgb() function and have written an improved
EXRGBHSV example that adds changing colour-bars underneath the sliders so
you can see how the colours will be changed by changing the sliders. Should
I post this here as well?


Take care,


Andrei.





Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/