forked from deater/linux_logo
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.CUSTOM_LOGOS
140 lines (98 loc) · 4.95 KB
/
README.CUSTOM_LOGOS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
How to Use the new custom logo tools
------------------------------------
++++++++++++++++++++++++++++++++++++
Quick Summary of The -L command line option:
-------------------------------------------
"linux_logo -L list"
will list all of the logos available
"linux_logo -L NAME" will display the logo with name NAME,
which you can see with the "-L list" command
"linux_logo -L num" will display logo number num, where the number is
obtained using the "-L list" command
"linux_logo -L random_xy" will pick a logo at random, with
criteria xy.
When you replace x with the letter:
b : pick a random banner mode logo
c : pick a random classic mode logo
e : pick a logo from either banner or classic
When you replace y with the letter:
a: pick a random ascii logo
n: pick a non-ascii logo
e: pick either type of logo
So to summarize "-L random_ba" picks a random ascii banner,
"-L random_ce" picks a random classic logo
"-L random_ee" picks any logo, etc, etc
Add logos by editing the "logo_config" file and re-running "make":
-----------------------------------------------------------------
The file "logo_config" holds the files that are compiled in.
It is simply a list of file-names.
Just add the names of your logos, and they will be compiled in.
Order is important; the order they are listen in "logo_config" is
the order they will appear in a "linux_logo -L list" command.
Also, the options "-c" (classic) "-b" (banner) and "-a" (ascii) depend
on this order; all they do is start with logo #1 and search down the
list for an appropriate logo.
When you have finished adding logos, recompile with "make". The
change to logo_config should be detected, "parse_logos" should run
on the file to ready the files for compiling in. Any errors should
be printed to the screen.
Creating custom logo files:
---------------------------
By default custom logo files are in the "./logos" directory tree.
You can test out logos without compiling them in by using the
"linux_logo -D filename" option, where filename is the path
to a .logo file
The .logo file format is simple:
--------------------------------
+ See the ./logos directory for examples
+ Any line starting with a "#" is a comment and ignored
+ First comes some info about the logo. A directive is all in caps,
starting at the far left of a line. After the directive is a space
followed by the appropriate value.
+ Directives:
SYSINFO_POSITION
possible values:
bottom - indicates a banner-type logo follows
right - indicates a classic-style logo follows
DESCRIPTION_STRING
the characters following the space until the new-line are taken
as a description of the logos.
NAME
the name used when searching for logos by name.
Please keep it short, without any spaces, and not conflicting with
any other logo names.
BEGIN_LOGO
END_LOGO
between these two directives should be the logo information for
the full-color logo. This can just be simply the output of an
editor or an ansi-editor [see references].
The character sequence ^[ is interpreted at the escape (#27)
character.
A banner logo can be any length, but typically 80 wide by 12 high
is standard. Also, the sysinfo will be centered, so keep that in
mind.
A classic logo is usually a picture 22 wide by 16 high, with
the OS name printed in block letters to the right of the first
6 lines. The system information is then printed starting on
line 8 and until the sysinfo runs out [typicall between 5-8 lines].
BEGIN_ASCII_LOGO
END_ASCII_LOGO
If available, an ascii version of the logo [with no escape
sequences] can be included between these two directives. Sizing
info is the same as for a normal logo.
+ Be sure to remember to end your directives, and not to nest logo
directives. I have not tested the parser to see how robust it is.
+ Be sure to have both a LOGO and a ASCII_LOGO in the logo file
if not, parse_logo will not be able to add them (core dump :(
You might use the script in contrib/script/logo2ascii in order to
convert them.
References:
----------
A good ansi editor [under development] from Adam Lackorzynski
can be obtained at http://www.inf.tu-dresden.de/~al10/aae/
For DOS/Windows I recommend TheDraw ansi editor.
Some tools to convert from graphic formats to ascii art can be found
in the netpbm toolkit at
ftp://wuarchive.wustl.edu/graphics/graphics/packages/NetPBM/
(useful to change your cool logo from gif/jpeg to ascii)
Search for "Ansi Editor" on freshmeat.net for more.