Application Icon: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		The application icon is usually displayed on the main window of the application, and it can be changed as per the code in [[Changing application Icon]].
2	2
3	3		To change the icon of the executable itself, it is necessary to employ a platform-dependent technique. In Lazarus 0.9.27 support for this was added to the Project Options dialog, but it currently doesn't work for Linux because it requires calling an application to set the icon.
4	4
5	5		## IDE support for the Application Icon
6	6
7	7		Just set the icon in the Project Options dialog, accessible in the Project menu.
8	8
9	9		Works for Windows and macOS.
10	10
11	11		## Platform-specific techniques
12	12
13	13		### Windows
14	14
15	15		1\. Create a new file named "project.rc" (for example) containing:
16	16
17		-	~~` MAINICON ICON "editor.ico" `~~
	17	+	```
	18	+	MAINICON ICON "editor.ico"
	19	+	```
18	20
19	21		2\. Include in you project *.lpr file the following instruction:
20	22
21		-	~~` {$R project.rc} `~~
	23	+	```
	24	+	{$R project.rc}
	25	+	```
22	26
23	27		Work with version 0.9.24 and above.
24	28
25	29		3\. In the article [[Windows Icon]] you can see the best practices for creating the icon.
26	30
27	31		### Setting the Application Icon on macOS
28	32
29	33		Under macOS it is necessary to set an icon for the Application Bundle. This is done by adding a field to the Info.plist file, like this:
30	34
31	35		``` xml
32	36		<key>CFBundleIconFile</key>
33	37		<string>iconfile.icns</string>
34	38		```
35	39
36	40		Where iconfile.icns is located inside MyBundle.app/Contents/Resources
37	41
38	42		You can find instructions to create an icns file [here](http://www.macinstruct.com/node/59)
39	43
40	44		### Linux
41	45
42	46		Under Linux application icons are located in special directories which are different on each Window Manager. The structure inside that directory, however, is standardized and described on the [Icon Theme Specification](http://www.freedesktop.org/Standards/icon-theme-spec).
43	47
44	48		In order to determine how an application is launched the operating system uses a text file with the extension .application. This file provides different information including a description of the application, categories and locations of the executable and the icon. The standard is described in the [Desktop Entry Specification](http://www.freedesktop.org/wiki/Specifications/desktop-entry-spec/) of freedesktop.org.
45	49
46	50		#### K Desktop Environment (KDE)
47	51
48	52		You can find the directory for application icons for use by all users and for each user using the command:
49	53
50		-	~~`kde-config --path icon`~~
	54	+	```
	55	+	kde-config --path icon
	56	+	```
51	57
52	58		This should print a list of colon-separated paths to stdout.
53	59
54	60		#### GNOME
55	61
56	62		You can find the directory for application icons for use by all users and for each user using the command:
57	63
58		-	~~`gnome-config --datadir`~~
	64	+	```
	65	+	gnome-config --datadir
	66	+	```
59	67
60	68		This should print a path to stdout, inside which is found a directory called pixmaps that attends to the Icon Theme Specification.
61	69
62	70		#### LXDE
63	71
64	72		In LXDE, icons are located in the directory
65	73
66		-	~~`/usr/share/pixmaps`~~
	74	+	```
	75	+	/usr/share/pixmaps
	76	+	```
67	77
68	78		.application files are in
69	79
70		-	~~`/usr/share/applications`~~
	80	+	```
	81	+	/usr/share/applications
	82	+	```
71	83
72	84		---
73	85		From the Free Pascal wiki, page "Application Icon", as it stood on 2020-08-02 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).
74	86		Category: GUI
75	87		Category: Lazarus

Back to history