rockbox-gigabeatfx

8/7/2019 rockbox-gigabeatfx

http://slidepdf.com/reader/full/rockbox-gigabeatfx 1/225

T h e R o c k b o x M a n u a l

f o r

T o s h i b a G i g a b e a t F a n d X S e r i e s

r o c k b o x . o r g

F e b r u a r y 2 , 2 0 1 1



2

R o c k b o x

h t t p : / / w w w . r o c k b o x . o r g /

O p e n S o u r c e J u k e b o x F i r m w a r e

R o c k b o x a n d t h i s m a n u a l i s t h e c o l l a b o r a t i v e e o r t o f t h e R o c k b o x t e a m a n d

i t s c o n t r i b u t o r s . S e e t h e a p p e n d i x f o r a c o m p l e t e l i s t o f c o n t r i b u t o r s .

c 2 0 0 3 - 2 0 1 0 T h e R o c k b o x T e a m a n d i t s c o n t r i b u t o r s ,

c 2 0 0 4 C h r i s t i A l i c e

S c a r b o r o u g h ,

c 2 0 0 3 J o s é M a r i a G a r c i a - V a l d e c a s a s B e r n a l & P e t e r S c h l e n k e r .

V e r s i o n r 2 9 1 8 4 - 1 1 0 2 0 2 . B u i l t u s i n g p d f L

A

T

E

X .

P e r m i s s i o n i s g r a n t e d t o c o p y , d i s t r i b u t e a n d / o r m o d i f y t h i s d o c u m e n t u n d e r

t h e t e r m s o f t h e G N U F r e e D o c u m e n t a t i o n L i c e n s e , V e r s i o n 1 . 2 o r a n y l a t e r

v e r s i o n p u b l i s h e d b y t h e F r e e S o f t w a r e F o u n d a t i o n ; w i t h n o I n v a r i a n t S e c -

t i o n s , n o F r o n t - C o v e r T e x t s , a n d n o B a c k - C o v e r T e x t s . A c o p y o f t h e l i c e n s e

i s i n c l u d e d i n t h e s e c t i o n e n t i t l e d G N U F r e e D o c u m e n t a t i o n L i c e n s e .

T h e R o c k b o x m a n u a l T o s h i b a G i g a b e a t F a n d X S e r i e s

http://www.rockbox.org/



C o n t e n t s 3

C o n t e n t s

1 . I n t r o d u c t i o n 1 0

1 . 1 . W e l c o m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0

1 . 2 . G e t t i n g m o r e h e l p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0

1 . 3 . N a m i n g c o n v e n t i o n s a n d m a r k s . . . . . . . . . . . . . . . . . . . . . . . . 1 1

2 . I n s t a l l a t i o n 1 2

2 . 1 . B e f o r e S t a r t i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2

2 . 2 . I n s t a l l i n g R o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2

2 . 2 . 1 . A u t o m a t e d I n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . 1 3

2 . 2 . 2 . M a n u a l I n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4

2 . 2 . 3 . F i n i s h i n g t h e i n s t a l l . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5

2 . 2 . 4 . E n a b l i n g S p e e c h S u p p o r t ( o p t i o n a l ) . . . . . . . . . . . . . . . . . 1 6

2 . 3 . R u n n i n g R o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6

2 . 4 . U p d a t i n g R o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6

2 . 5 . U n i n s t a l l i n g R o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6

2 . 5 . 1 . A u t o m a t i c U n i n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . 1 6

2 . 5 . 2 . M a n u a l U n i n s t a l l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . 1 6

2 . 6 . T r o u b l e s h o o t i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7

3 . Q u i c k S t a r t 1 8

3 . 1 . B a s i c O v e r v i e w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8

3 . 1 . 1 . T h e p l a y e r ' s c o n t r o l s . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8

3 . 1 . 2 . T u r n i n g t h e p l a y e r o n a n d o . . . . . . . . . . . . . . . . . . . . . 1 9

3 . 1 . 3 . P u t t i n g m u s i c o n y o u r p l a y e r . . . . . . . . . . . . . . . . . . . . . 1 9

3 . 1 . 4 . T h e r s t c o n t a c t . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0

3 . 1 . 5 . B a s i c c o n t r o l s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0

3 . 1 . 6 . B a s i c c o n c e p t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0

3 . 2 . C u s t o m i s i n g R o c k b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1

3 . 3 . U S B C h a r g i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1

4 . B r o w s i n g a n d p l a y i n g 2 2

4 . 1 . F i l e B r o w s e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2

4 . 1 . 1 . F i l e B r o w s e r C o n t r o l s . . . . . . . . . . . . . . . . . . . . . . . . . 2 3

4 . 1 . 2 . C o n t e x t M e n u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 4

4 . 1 . 3 . V i r t u a l K e y b o a r d . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 6

4 . 2 . D a t a b a s e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 7

4 . 2 . 1 . I n t r o d u c t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 7




C o n t e n t s 5

6 . 9 . D i t h e r i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2

6 . 1 0 . T i m e s t r e t c h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 2

6 . 1 1 . C o m p r e s s o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3

7 . P l a y b a c k S e t t i n g s 5 4

7 . 1 . S h u e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 4

7 . 2 . R e p e a t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 4

7 . 3 . P l a y S e l e c t e d F i r s t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 4 . F a s t - F o r w a r d / R e w i n d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 5 . A n t i - S k i p B u e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 6 . F a d e o n S t o p / P a u s e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 7 . P a r t y M o d e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 8 . C r o s s f a d e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5

7 . 9 . R e p l a y g a i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 7

7 . 1 0 . T r a c k S k i p B e e p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 8

7 . 1 1 . A u t o - C h a n g e D i r e c t o r y . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 8

7 . 1 2 . P a u s e o n H e a d p h o n e U n p l u g . . . . . . . . . . . . . . . . . . . . . . . . . 5 8

7 . 1 3 . L a s t . f m L o g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 9

7 . 1 4 . C u e s h e e t S u p p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 9

7 . 1 5 . S k i p L e n g t h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 9

7 . 1 6 . P r e v e n t T r a c k S k i p p i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 9

7 . 1 7 . R e w i n d B e f o r e R e s u m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 9

8 . G e n e r a l S e t t i n g s 6 1

8 . 1 . P l a y l i s t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1

8 . 2 . F i l e V i e w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1

8 . 3 . D a t a b a s e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3

8 . 4 . D i s p l a y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3

8 . 5 . S y s t e m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

8 . 5 . 1 . S t a r t S c r e e n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

8 . 5 . 2 . B a t t e r y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

8 . 5 . 3 . D i s k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6

8 . 5 . 4 . I d l e P o w e r o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7

8 . 5 . 5 . L i m i t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7

8 . 5 . 6 . C a r A d a p t e r M o d e . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7

8 . 5 . 7 . B u t t o n L i g h t T i m e o u t . . . . . . . . . . . . . . . . . . . . . . . . . 6 8

8 . 5 . 8 . B u t t o n L i g h t B r i g h t n e s s . . . . . . . . . . . . . . . . . . . . . . . . 6 8

8 . 6 . B o o k m a r k i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 8

8 . 7 . L a n g u a g e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 0

8 . 8 . V o i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 0

8 . 9 . H o t k e y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1

9 . T h e m e S e t t i n g s 7 2




C o n t e n t s 6

1 0 . P l u g i n s 7 4

1 0 . 1 . G a m e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 4

1 0 . 1 . 1 . B l a c k j a c k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 5

1 0 . 1 . 2 . B r i c k M a n i a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 6

1 0 . 1 . 3 . B u b b l e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7

1 0 . 1 . 4 . C h e s s b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 8

1 0 . 1 . 5 . C l i x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 9

1 0 . 1 . 6 . C h o p p e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 0

1 0 . 1 . 7 . C o d e b u s t e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1

1 0 . 1 . 8 . D i c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 1

1 0 . 1 . 9 . D o o m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 2

1 0 . 1 . 1 0 . F l i p i t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 4

1 0 . 1 . 1 1 . G o b a n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5

1 0 . 1 . 1 2 . I n v a d r o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 0

1 0 . 1 . 1 3 . J a c k p o t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1

1 0 . 1 . 1 4 . J e w e l s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2

1 0 . 1 . 1 5 . M a z e z a M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3

1 0 . 1 . 1 6 . M i n e s w e e p e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 4

1 0 . 1 . 1 7 . P a c b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 5

1 0 . 1 . 1 8 . P e g b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 6

1 0 . 1 . 1 9 . P o n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 7

1 0 . 1 . 2 0 . R e v e r s i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 8

1 0 . 1 . 2 1 . R o b o t n d s k i t t e n . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 8

1 0 . 1 . 2 2 . R o c k b l o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 9

1 0 . 1 . 2 3 . R o c k b l o x 1 d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 0

1 0 . 1 . 2 4 . R o c k l i f e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 0

1 0 . 1 . 2 5 . S l i d i n g P u z z l e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 1

1 0 . 1 . 2 6 . S n a k e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 2

1 0 . 1 . 2 7 . S n a k e 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 3

1 0 . 1 . 2 8 . S o k o b a n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 4

1 0 . 1 . 2 9 . S o l i t a i r e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 6

1 0 . 1 . 3 0 . S p a c e r o c k s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 7

1 0 . 1 . 3 1 . S t a r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 8

1 0 . 1 . 3 2 . S u d o k u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 0 9

1 0 . 1 . 3 3 . W o r m l e t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1

1 0 . 1 . 3 4 . X o b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 4

1 0 . 2 . D e m o s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 5

1 0 . 2 . 1 . B o u n c e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 5

1 0 . 2 . 2 . C r e d i t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 6

1 0 . 2 . 3 . C u b e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 6

1 0 . 2 . 4 . D e m y s t i f y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 7

1 0 . 2 . 5 . F i r e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 8

1 0 . 2 . 6 . F r a c t a l s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 9

1 0 . 2 . 7 . L o g o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 9




C o n t e n t s 7

1 0 . 2 . 8 . M o s a i q u e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 0

1 0 . 2 . 9 . O s c i l l o s c o p e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 1

1 0 . 2 . 1 0 . P i c t u r e F l o w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 2

1 0 . 2 . 1 1 . P l a s m a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 4

1 0 . 2 . 1 2 . S n o w . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 5

1 0 . 2 . 1 3 . S t a r e l d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 6

1 0 . 2 . 1 4 . V U m e t e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 7

1 0 . 3 . V i e w e r s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 7

1 0 . 3 . 1 . S h o r t c u t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 8

1 0 . 3 . 2 . C h i p - 8 E m u l a t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 2 9

1 0 . 3 . 3 . F r o t z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 0

1 0 . 3 . 4 . I m a g e V i e w e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 1

1 0 . 3 . 5 . L u a s c r i p t i n g l a n g u a g e . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 2

1 0 . 3 . 6 . M i d i p l a y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 3

1 0 . 3 . 7 . M P E G P l a y e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 3

1 0 . 3 . 8 . M P 3 E n c o d e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 5

1 0 . 3 . 9 . R o c k b o y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 6

1 0 . 3 . 1 0 . S e a r c h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 7

1 0 . 3 . 1 1 . S h o p p e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 7

1 0 . 3 . 1 2 . S o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 7

1 0 . 3 . 1 3 . T e x t V i e w e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 3 8

1 0 . 3 . 1 4 . T h e m e R e m o v e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 3

1 0 . 3 . 1 5 . V B R x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 4

1 0 . 3 . 1 6 . Z X B o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 5

1 0 . 4 . A p p l i c a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 7

1 0 . 4 . 1 . A l a r m C l o c k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 7

1 0 . 4 . 2 . B a t t e r y B e n c h m a r k . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 7

1 0 . 4 . 3 . C a l c u l a t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 4 9

1 0 . 4 . 4 . C a l e n d a r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 0

1 0 . 4 . 5 . C h e s s C l o c k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 1

1 0 . 4 . 6 . C l o c k . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 2

1 0 . 4 . 7 . D i s k T i d y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 5

1 0 . 4 . 8 . K e y b o x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 5

1 0 . 4 . 9 . L a m p . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 6

1 0 . 4 . 1 0 . L r c p l a y e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 6

1 0 . 4 . 1 1 . m d 5 s u m . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 9

1 0 . 4 . 1 2 . M e t r o n o m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 5 9

1 0 . 4 . 1 3 . R a n d o m F o l d e r A d v a n c e C o n g u r a t i o n . . . . . . . . . . . . . . . . 1 5 9

1 0 . 4 . 1 4 . R e s i s t o r C a l c u l a t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 0

1 0 . 4 . 1 5 . R o c k p a i n t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 1

1 0 . 4 . 1 6 . S t a t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 4

1 0 . 4 . 1 7 . S t o p w a t c h . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 5

1 0 . 4 . 1 8 . T e x t E d i t o r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 5




C o n t e n t s 8

1 1 . A d v a n c e d T o p i c s 1 6 7

1 1 . 1 . C u s t o m i s i n g t h e U s e r I n t e r f a c e . . . . . . . . . . . . . . . . . . . . . . . . 1 6 7

1 1 . 1 . 1 . G e t t i n g E x t r a s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 7

1 1 . 1 . 2 . L o a d i n g F o n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 7

1 1 . 1 . 3 . L o a d i n g L a n g u a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 7

1 1 . 1 . 4 . C h a n g i n g F i l e t y p e C o l o u r s . . . . . . . . . . . . . . . . . . . . . . 1 6 7

1 1 . 1 . 5 . L o a d i n g B a c k d r o p s . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 9

1 1 . 1 . 6 . U I V i e w p o r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 6 9

1 1 . 2 . C o n g u r i n g t h e T h e m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 0

1 1 . 2 . 1 . T h e m e i n g G e n e r a l I n f o . . . . . . . . . . . . . . . . . . . . . . . . 1 7 0

1 1 . 2 . 2 . T h e m e s C r e a t e Y o u r O w n . . . . . . . . . . . . . . . . . . . . . . 1 7 0

1 1 . 2 . 3 . I n f o V i e w p o r t ( S B S o n l y ) . . . . . . . . . . . . . . . . . . . . . . . 1 7 2

1 1 . 2 . 4 . A d d i t i o n a l F o n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 3

1 1 . 3 . M a n a g i n g R o c k b o x S e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 5

1 1 . 3 . 1 . I n t r o d u c t i o n t o . c f g F i l e s . . . . . . . . . . . . . . . . . . . . . . . 1 7 5

1 1 . 3 . 2 . S p e c i c a t i o n s f o r . c f g F i l e s . . . . . . . . . . . . . . . . . . . . . . 1 7 6

1 1 . 3 . 3 . T h e M a n a g e S e t t i n g s m e n u . . . . . . . . . . . . . . . . . . . . 1 7 7

1 1 . 4 . F i r m w a r e L o a d i n g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 7

1 1 . 4 . 1 . U s i n g R O L O ( R o c k b o x L o a d e r ) . . . . . . . . . . . . . . . . . . . . 1 7 7

1 1 . 5 . O p t i m i s i n g b a t t e r y r u n t i m e . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 7

1 1 . 5 . 1 . D i s p l a y b a c k l i g h t . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 8

1 1 . 5 . 2 . D i s p l a y p o w e r - o . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 8

1 1 . 5 . 3 . A n t i - S k i p B u e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 8

1 1 . 5 . 4 . R e p l a y g a i n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 8

1 1 . 5 . 5 . A u d i o f o r m a t a n d b i t r a t e . . . . . . . . . . . . . . . . . . . . . . . 1 7 8

1 1 . 5 . 6 . S o u n d s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 7 9

A . F i l e f o r m a t s 1 8 0

A . 1 . S u p p o r t e d l e f o r m a t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 1

A . 2 . S u p p o r t e d a u d i o f o r m a t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 2

A . 2 . 1 . L o s s y C o d e c s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 2

A . 2 . 2 . L o s s l e s s C o d e c s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 3

A . 2 . 3 . O t h e r C o d e c s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 4

B . T h e m e T a g s 1 8 5

B . 1 . S t a t u s B a r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 5

B . 2 . H a r d w a r e C a p a b i l i t i e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 5

B . 3 . I n f o r m a t i o n f r o m t h e t r a c k t a g s . . . . . . . . . . . . . . . . . . . . . . . . 1 8 6

B . 4 . V i e w p o r t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 6

B . 5 . A d d i t i o n a l F o n t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 6

B . 6 . P o w e r R e l a t e d I n f o r m a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 7

B . 7 . I n f o r m a t i o n a b o u t t h e l e . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 7

B . 8 . P l a y l i s t / S o n g I n f o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 8

B . 9 . P l a y l i s t V i e w e r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 9




C o n t e n t s 9

B . 1 0 . R u n t i m e D a t a b a s e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 9

B . 1 1 . S o u n d ( D S P ) s e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 8 9

B . 1 2 . H o l d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 0

B . 1 3 . V i r t u a l L E D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 0

B . 1 4 . R e p e a t M o d e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 0

B . 1 5 . P l a y b a c k M o d e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 0

B . 1 6 . C u r r e n t S c r e e n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 0

B . 1 7 . L i s t T i t l e ( . s b s o n l y ) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 1

B . 1 8 . C h a n g i n g V o l u m e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 1

B . 1 9 . S e t t i n g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 1

B . 2 0 . I m a g e s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 2

B . 2 1 . A l b u m A r t . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 3

B . 2 1 . 1 . L i m i t a t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 3

B . 2 1 . 2 . W h e r e t o p u t a l b u m a r t . . . . . . . . . . . . . . . . . . . . . . . . 1 9 3

B . 2 1 . 3 . H o w t o d i s p l a y t h e a l b u m a r t . . . . . . . . . . . . . . . . . . . . . 1 9 4

B . 2 2 . A l i g n m e n t a n d l a n g u a g e d i r e c t i o n . . . . . . . . . . . . . . . . . . . . . . . 1 9 5

B . 2 3 . C o n d i t i o n a l T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 5

B . 2 4 . S u b l i n e T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 6

B . 2 5 . T i m e a n d D a t e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 6

B . 2 6 . T e x t T r a n s l a t i o n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 6

B . 2 7 . B a r T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 7

B . 2 7 . 1 . O p t i o n s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 7

B . 2 8 . O t h e r T a g s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 9 8

C . C o n g l e o p t i o n s 1 9 9

D . M e n u O v e r v i e w 2 0 4

E . U s e r f e e d b a c k 2 0 5

E . 1 . B u g r e p o r t s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0 5

E . 1 . 1 . R u l e s f o r s u b m i t t i n g n e w b u g r e p o r t s . . . . . . . . . . . . . . . . . 2 0 5

E . 2 . F e a t u r e i d e a s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 0 5

E . 2 . 1 . R u l e s f o r s u b m i t t i n g a n e w f e a t u r e i d e a . . . . . . . . . . . . . . . 2 0 5

E . 2 . 2 . F e a t u r e s w e w i l l n o t i m p l e m e n t . . . . . . . . . . . . . . . . . . . . 2 0 6

F . C r e d i t s 2 0 7

G . L i c e n s e s 2 1 1

G . 1 . G N U F r e e D o c u m e n t a t i o n L i c e n s e . . . . . . . . . . . . . . . . . . . . . . 2 1 1

G . 2 . T h e G N U G e n e r a l P u b l i c L i c e n s e . . . . . . . . . . . . . . . . . . . . . . . 2 1 9




C h a p t e r 1 . I n t r o d u c t i o n 1 0

1 . I n t r o d u c t i o n

1 . 1 . W e l c o m e

T h i s i s t h e m a n u a l f o r R o c k b o x . R o c k b o x i s a n o p e n s o u r c e r m w a r e r e p l a c e m e n t f o r a

g r o w i n g n u m b e r o f d i g i t a l a u d i o p l a y e r s . R o c k b o x a i m s t o b e c o n s i d e r a b l y m o r e f u n c -

t i o n a l a n d e c i e n t t h a n y o u r d e v i c e ' s s t o c k r m w a r e w h i l e r e m a i n i n g e a s y t o u s e a n d

c u s t o m i s a b l e . R o c k b o x i s w r i t t e n b y u s e r s , f o r u s e r s . N o t o n l y i s i t f r e e t o u s e , i t i s a l s o

r e l e a s e d u n d e r t h e G N U G e n e r a l P u b l i c L i c e n s e ( G P L ) , w h i c h m e a n s t h a t i t w i l l a l w a y s

r e m a i n f r e e b o t h t o u s e a n d t o c h a n g e .

R o c k b o x h a s b e e n i n d e v e l o p m e n t s i n c e 2 0 0 1 , a n d r e c e i v e s n e w f e a t u r e s , t w e a k s a n d

x e s e a c h d a y t o p r o v i d e y o u w i t h t h e b e s t p o s s i b l e e x p e r i e n c e o n y o u r d i g i t a l a u d i o

p l a y e r . A m a j o r g o a l o f R o c k b o x i s t o b e s i m p l e a n d e a s y t o u s e , y e t r e m a i n v e r y c u s -

t o m i s a b l e a n d c o n g u r a b l e . W e b e l i e v e t h a t y o u s h o u l d n e v e r n e e d t o g o t h r o u g h a s e r i e s

o f m e n u s f o r a n a c t i o n y o u p e r f o r m f r e q u e n t l y . W e a l s o b e l i e v e t h a t y o u s h o u l d b e a b l e

t o c o n g u r e a l m o s t a n y t h i n g a b o u t R o c k b o x y o u c o u l d w a n t , p e r t a i n i n g t o f u n c t i o n a l i t y .

A n o t h e r t o p p r i o r i t y o f R o c k b o x i s a u d i o p l a y b a c k q u a l i t y R o c k b o x , f o r m o s t m o d e l s ,

i n c l u d e s a w i d e r r a n g e o f s o u n d s e t t i n g s t h a n t h e d e v i c e ' s o r i g i n a l r m w a r e . A l o t o f

w o r k h a s b e e n p u t i n t o m a k i n g R o c k b o x s o u n d t h e b e s t i t c a n , a n d i m p r o v e m e n t s a r e

c o n s t a n t l y b e i n g m a d e . A l l m o d e l s h a v e a c c e s s t o a l a r g e n u m b e r o f p l u g i n s , i n c l u d i n g

m a n y g a m e s , a p p l i c a t i o n s , a n d g r a p h i c a l d e m o s . Y o u c a n l o a d d i e r e n t c o n g u r a t i o n s

q u i c k l y f o r d i e r e n t p u r p o s e s ( e . g . a l a r g e f o n t f o r i n y o u r c a r , d i e r e n t s o u n d s e t t i n g s

f o r a t h o m e ) . R o c k b o x f e a t u r e s a v e r y w i d e r a n g e o f l a n g u a g e s , a n d a l l s u p p o r t e d m o d e l s

a l s o h a v e t h e a b i l i t y t o t a l k t o y o u m e n u s c a n b e v o i c e d a n d l e n a m e s s p e l l e d o u t o r

s p o k e n .

1 . 2 . G e t t i n g m o r e h e l p

T h i s m a n u a l i s i n t e n d e d t o b e a c o m p r e h e n s i v e i n t r o d u c t i o n t o t h e R o c k b o x r m w a r e .

T h e r e i s , h o w e v e r , m o r e h e l p a v a i l a b l e . T h e R o c k b o x w e b s i t e a t h t t p : / / w w w . r o c k b o x . o r g /

c o n t a i n s v e r y e x t e n s i v e d o c u m e n t a t i o n a n d g u i d e s w r i t t e n b y m e m b e r s o f t h e R o c k b o x

c o m m u n i t y a n d t h i s s h o u l d b e y o u r r s t p o r t o f c a l l w h e n l o o k i n g f o r f u r t h e r h e l p .

I f y o u c a n n o t n d t h e i n f o r m a t i o n y o u a r e s e a r c h i n g f o r o n t h e R o c k b o x w e b s i t e t h e r e

a r e a n u m b e r o f s u p p o r t c h a n n e l s y o u s h o u l d h a v e a l o o k a t . Y o u c a n t r y t h e R o c k b o x

f o r u m s l o c a t e d a t h t t p : / / f o r u m s . r o c k b o x . o r g / . T h e m a i l i n g l i s t s a r e a n o t h e r o p t i o n , a n d

c a n b e f o u n d a t h t t p : / / w w w . r o c k b o x . o r g / m a i l / . F r o m t h a t p a g e y o u c a n s u b s c r i b e t o t h e

l i s t s a n d b r o w s e t h e a r c h i v e s . T o s e a r c h t h e l i s t a r c h i v e s s i m p l y u s e t h e s e a r c h e l d t h a t

i s l o c a t e d o n t h e l e f t s i d e o f t h e w e b s i t e . F u r t h e r m o r e , y o u c a n a s k o n I R C . T h e m a i n


http://www.rockbox.org/mail/

http://forums.rockbox.org/

http://www.rockbox.org/



C h a p t e r 1 . I n t r o d u c t i o n 1 1

c h a n n e l f o r R o c k b o x i s # r o c k b o x o n i r c : / / i r c . f r e e n o d e . n e t . M a n y h e l p f u l d e v e l o p e r s a n d

u s e r s a r e u s u a l l y a r o u n d . J u s t j o i n a n d a s k y o u r q u e s t i o n ( d o n ' t a s k t o a s k ! ) i f s o m e o n e

k n o w s t h e a n s w e r y o u ' l l u s u a l l y g e t a n a n s w e r p r e t t y q u i c k l y . M o r e i n f o r m a t i o n i n c l u d i n g

I R C l o g s c a n b e f o u n d a t h t t p : / / w w w . r o c k b o x . o r g / i r c / . W e a l s o h a v e a w e b c l i e n t s o t h a t

y o u c a n j o i n t h e R o c k b o x I R C c h a n n e l w i t h o u t n e e d i n g t o i n s t a l l a d d i t i o n a l s o f t w a r e

o n t o y o u r c o m p u t e r .

I f y o u t h i n k y o u h a v e f o u n d a b u g p l e a s e m a k e s u r e i t a c t u a l l y i s a b u g a n d i s s t i l l

p r e s e n t i n t h e m o s t r e c e n t v e r s i o n o f R o c k b o x . Y o u s h o u l d t r y t o c o n r m t h a t b y u s i n g

t h e a b o v e m e n t i o n e d s u p p o r t c h a n n e l s r s t . A f t e r t h a t y o u c a n s u b m i t t h a t i s s u e t o o u r

t r a c k e r . R e f e r t o s e c t i o n E ( p a g e 2 0 5 ) f o r d e t a i l s o n h o w t o u s e t h e t r a c k e r .

1 . 3 . N a m i n g c o n v e n t i o n s a n d m a r k s

W e h a v e s o m e c o n v e n t i o n s ( e s p e c i a l l y f o r n a m i n g ) t h a t a r e i n t e n d e d t o b e c o n s i s t e n t

t h r o u g h o u t t h i s m a n u a l .

M a n u f a c t u r e r a n d p r o d u c t n a m e s a r e f o r m a t t e d i n a c c o r d a n c e w i t h t h e s t a n d a r d r u l e s

o f E n g l i s h g r a m m a r , e . g . T o s h i b a p l a y b a c k i s c u r r e n t l y u n s u p p o r t e d . M a n u f a c t u r e r

a n d m o d e l n a m e s a r e p r o p e r n o u n s , a n d t h u s a r e w r i t t e n b e g i n n i n g w i t h a c a p i t a l l e t t e r .

T h i s m a n u a l h a s s o m e p a r t s t h a t a r e m a r k e d w i t h i c o n s o n t h e m a r g i n t o h e l p y o u

n d i n g i m p o r t a n t p a r t s o r p a r t s y o u c o u l d s k i p . T h e f o l l o w i n g i c o n s a r e u s e d :

N o t e : T h i s i n d i c a t e s a n o t e . A n o t e s t a r t s a l w a y s w i t h t h e t e x t N o t e . I n o r d e r t o m a k e b n d i n g n o t e s e a s i e r e a c h o n e i s a c c o m p a n i e d b y a n i c o n i n t h e m a r g i n a s h e r e . N o t e s a r e

u s e d t o m a r k u s e f u l i n f o r m a t i o n t h a t m a y h e l p y o u t o g e t t h e m o s t o u t o f R o c k b o x .

W a r n i n g : T h i s i s a w a r n i n g . I n c o n t r a s t t o n o t e s m e n t i o n e d a b o v e , a w a r n i n g s h o u l d

!b e t a k e n m o r e s e r i o u s l y . W h e r e a s i g n o r i n g n o t e s w i l l n o t c a u s e a n y s e r i o u s d a m a g e ,

i g n o r i n g w a r n i n g s c o u l d c a u s e s e r i o u s d a m a g e t o y o u r p l a y e r . Y o u r e a l l y s h o u l d r e a d t h e

w a r n i n g s , e s p e c i a l l y i f y o u a r e n e w t o R o c k b o x .

T h i s i c o n m a r k s a s e c t i o n t h a t i s i n t e n d e d e s p e c i a l l y f o r t h e b l i n d a n d v i s u a l l y i m - ¸p a i r e d . A s t h e y c a n n o t r e a d t h e m a n u a l i n t h e s a m e w a y s i g h t e d p e o p l e d o w e h a v e

a d d e d s o m e a d d i t i o n a l d e s c r i p t i o n s . I f y o u a r e n o t b l i n d o r v i s u a l l y i m p a i r e d y o u c a n

p r o b a b l y c o m p l e t e l y s k i p t h e s e b l o c k s . T o m a k e t h i s e a s i e r , t h e r e i s a n i c o n s h o w n i n t h e

m a r g i n o n t h e r i g h t .

L i n k s t o t h e w i k i a r e a b b r e v i a t e d b y t h e n a m e o f t h e w i k i p a g e . T h o s e n a m e s a r e s t i l l

l i n k e d s o y o u c a n s i m p l y f o l l o w t h e m l i k e a n y o t h e r l i n k i n t h i s m a n u a l . I f y o u w a n t t o

a c c e s s a w i k i p a g e m a n u a l l y g o t o Z h t t p : / / w w w . r o c k b o x . o r g / w i k i / a n d t y p e t h e p a g e

n a m e i n t h e G o b o x a t t h e t o p o f t h e p a g e . L i n k s t o w i k i p a g e s a r e a l s o i n d i c a t e d b y

t h e s y m b o l Z i n f r o n t o f t h e p a g e n a m e .


http://www.rockbox.org/wiki/

http://www.rockbox.org/irc/

http://irc//irc.freenode.net



C h a p t e r 2 . I n s t a l l a t i o n 1 2

2 . I n s t a l l a t i o n

I n s t a l l i n g R o c k b o x i s g e n e r a l l y a q u i c k a n d e a s y p r o c e d u r e . H o w e v e r b e f o r e b e g i n n i n g

t h e r e a r e a f e w t h i n g s i t i s i m p o r t a n t t o k n o w .

2 . 1 . B e f o r e S t a r t i n g

U S B c o n n e c t i o n . T o t r a n s f e r R o c k b o x t o y o u r p l a y e r y o u n e e d t o c o n n e c t i t t o y o u r c o m -

p u t e r . F o r m a n u a l i n s t a l l a t i o n / u n i n s t a l l a t i o n , o r s h o u l d a u t o d e t e c t i o n f a i l d u r i n g

a u t o m a t i c i n s t a l l a t i o n , y o u n e e d t o k n o w w h e r e t o a c c e s s t h e p l a y e r . O n W i n d o w s

t h i s m e a n s y o u n e e d t o k n o w t h e d r i v e l e t t e r a s s o c i a t e d w i t h t h e p l a y e r . O n L i n u x

y o u n e e d t o k n o w t h e m o u n t p o i n t o f y o u r p l a y e r . O n M a c O S X y o u n e e d t o k n o w

t h e v o l u m e n a m e o f y o u r p l a y e r .

T h e i n s t a l l a t i o n r e q u i r e s y o u t o c h a n g e a s e t t i n g i n t h e o r i g i n a l r m w a r e . M a k e

s u r e t h e o p t i o n u n d e r S e t u p → C o n n e c t i o n s → P C C o n n e c t i o n s i s s e t t o

g i g a b e a t r o o m . A l s o , d u r i n g i n s t a l l a t i o n , d o n o t c o n n e c t y o u r p l a y e r u s i n g t h e

c r a d l e b u t p l u g t h e U S B c a b l e d i r e c t l y t o t h e p l a y e r .

2 . 2 . I n s t a l l i n g R o c k b o x

T h e r e a r e t w o w a y s t o i n s t a l l R o c k b o x : a u t o m a t e d a n d m a n u a l . T h e a u t o m a t e d w a y i s

t h e p r e f e r r e d m e t h o d o f i n s t a l l i n g R o c k b o x f o r t h e m a j o r i t y o f p e o p l e . R o c k b o x U t i l i t y

i s a g r a p h i c a l a p p l i c a t i o n t h a t d o e s a l m o s t e v e r y t h i n g f o r y o u . H o w e v e r , s h o u l d y o u

e n c o u n t e r a p r o b l e m , t h e n t h e m a n u a l w a y i s s t i l l a v a i l a b l e t o y o u .

T h e r e a r e t h r e e s e p a r a t e c o m p o n e n t s , t w o o f w h i c h n e e d t o b e i n s t a l l e d i n o r d e r t o r u n

R o c k b o x :

T h e T o s h i b a b o o t l o a d e r . T h e T o s h i b a b o o t l o a d e r i s t h e p r o g r a m t h a t t e l l s y o u r p l a y e r

h o w t o l o a d a n d s t a r t t h e o r i g i n a l r m w a r e . I t i s a l s o r e s p o n s i b l e f o r a n y e m e r g e n c y ,

r e c o v e r y , o r d i s k m o d e s o n y o u r p l a y e r . T h i s b o o t l o a d e r i s s t o r e d i n s p e c i a l a s h

m e m o r y i n y o u r T o s h i b a a n d c o m e s f a c t o r y - i n s t a l l e d . I t i s n o t n e c e s s a r y t o m o d i f y

t h i s i n o r d e r t o i n s t a l l R o c k b o x .

T h e R o c k b o x b o o t l o a d e r . T h e R o c k b o x b o o t l o a d e r i s l o a d e d f r o m d i s k b y t h e T o s h i b a

b o o t l o a d e r . I t i s r e s p o n s i b l e f o r l o a d i n g t h e R o c k b o x r m w a r e a n d f o r p r o v i d i n g

t h e d u a l b o o t f u n c t i o n . I t d i r e c t l y r e p l a c e s t h e T o s h i b a r m w a r e i n t h e p l a y e r ' s

b o o t s e q u e n c e .





N o t e : D u a l b o o t d o e s n o t c u r r e n t l y w o r k o n t h e G i g a b e a t . bT h e R o c k b o x r m w a r e . S i m i l a r t o t h e T o s h i b a r m w a r e , m o s t o f t h e R o c k b o x c o d e i s

c o n t a i n e d i n a b u i l d t h a t r e s i d e s o n y o u r p l a y e r ' s d r i v e . T h i s m a k e s i t e a s y t o

u p d a t e R o c k b o x . T h e b u i l d c o n s i s t s o f a d i r e c t o r y c a l l e d . r o c k b o x w h i c h c o n t a i n s

a l l o f t h e R o c k b o x l e s , a n d i s l o c a t e d i n t h e r o o t o f y o u r p l a y e r ' s d r i v e .

A p a r t f r o m t h e r e q u i r e d p a r t s t h e r e a r e s o m e a d d o n s y o u m i g h t b e i n t e r e s t e d i n i n -

s t a l l i n g .

F o n t s . R o c k b o x c a n l o a d c u s t o m f o n t s . T h e f o n t s a r e d i s t r i b u t e d a s a s e p a r a t e p a c k a g e

a n d t h u s n e e d t o b e i n s t a l l e d s e p a r a t e l y . T h e y a r e n o t r e q u i r e d t o r u n R o c k b o x

i t s e l f b u t a l o t o f t h e m e s r e q u i r e t h e f o n t s p a c k a g e t o b e i n s t a l l e d .

T h e m e s . T h e a p p e a r a n c e o f R o c k b o x c a n b e c u s t o m i s e d b y t h e m e s . D e p e n d i n g o n y o u r

t a s t e y o u m i g h t w a n t t o i n s t a l l a d d i t i o n a l t h e m e s t o c h a n g e t h e l o o k o f R o c k b o x .

2 . 2 . 1 . A u t o m a t e d I n s t a l l a t i o n

T o a u t o m a t i c a l l y i n s t a l l R o c k b o x , d o w n l o a d t h e o c i a l i n s t a l l e r a n d h o u s e k e e p i n g t o o l

R o c k b o x U t i l i t y . I t a l l o w s y o u t o :

• A u t o m a t i c a l l y i n s t a l l a l l n e e d e d c o m p o n e n t s f o r u s i n g R o c k b o x ( M i n i m a l I n s t a l -

l a t i o n ) .

• A u t o m a t i c a l l y i n s t a l l a l l s u g g e s t e d c o m p o n e n t s ( C o m p l e t e I n s t a l l a t i o n ) .

• S e l e c t i v e l y i n s t a l l o p t i o n a l c o m p o n e n t s .

• I n s t a l l a d d i t i o n a l f o n t s a n d t h e m e s .

• I n s t a l l v o i c e l e s a n d g e n e r a t e t a l k c l i p s .

• U n i n s t a l l a l l c o m p o n e n t s y o u i n s t a l l e d u s i n g R o c k b o x U t i l i t y .

P r e b u i l t b i n a r i e s f o r W i n d o w s , L i n u x a n d M a c O S X a r e a v a i l a b l e a t t h e Z R o c k b o x U t i l i t y

w i k i p a g e .

W h e n r s t s t a r t i n g R o c k b o x U t i l i t y r u n A u t o d e t e c t , f o u n d i n t h e c o n g u r a t i o n

d i a l o g ( F i l e → C o n g u r e ) . A u t o d e t e c t i o n c a n d e t e c t m o s t p l a y e r t y p e s . I f a u t o d e t e c t i o n

f a i l s o r i s u n a b l e t o d e t e c t t h e m o u n t p o i n t , m a k e s u r e t o e n t e r t h e c o r r e c t v a l u e s . T h e

m o u n t p o i n t i n d i c a t e s t h e l o c a t i o n o f t h e p l a y e r i n y o u r l e s y s t e m . O n W i n d o w s , t h i s

i s t h e d r i v e l e t t e r t h e p l a y e r g e t s a s s i g n e d , o n o t h e r s y s t e m s t h i s i s a p a t h i n t h e l e s y s t e m .


http://www.rockbox.org/wiki/RockboxUtility




C h o o s i n g a R o c k b o x v e r s i o n

T h e r e a r e t h r e e d i e r e n t v e r s i o n s o f R o c k b o x a v a i l a b l e f r o m t h e R o c k b o x w e b s i t e : R e l e a s e

v e r s i o n , c u r r e n t b u i l d a n d a r c h i v e d d a i l y b u i l d . Y o u n e e d t o d e c i d e w h i c h o n e y o u w a n t

t o i n s t a l l a n d g e t t h e a p p r o p r i a t e v e r s i o n f o r y o u r p l a y e r . I f y o u s e l e c t e i t h e r M i n i m a l

I n s t a l l a t i o n o r C o m p l e t e I n s t a l l a t i o n f r o m t h e Q u i c k S t a r t t a b , t h e n R o c k b o x U t i l i t y

w i l l a u t o m a t i c a l l y i n s t a l l t h e r e l e a s e v e r s i o n o f R o c k b o x . U s i n g t h e I n s t a l l a t i o n t a b w i l l

a l l o w y o u t o s e l e c t w h i c h v e r s i o n y o u w i s h t o i n s t a l l .

R e l e a s e . T h e r e l e a s e v e r s i o n i s t h e l a t e s t s t a b l e r e l e a s e , f r e e o f k n o w n c r i t i c a l b u g s .

F o r a m a n u a l i n s t a l l , t h e c u r r e n t s t a b l e r e l e a s e o f R o c k b o x i s a v a i l a b l e a t h t t p :

/ / w w w . r o c k b o x . o r g / d o w n l o a d / .

C u r r e n t B u i l d . T h e c u r r e n t b u i l d i s b u i l t a t e a c h s o u r c e c o d e c h a n g e t o t h e R o c k b o x

S V N r e p o s i t o r y a n d r e p r e s e n t s t h e c u r r e n t s t a t e o f R o c k b o x d e v e l o p m e n t . T h i s

m e a n s t h a t t h e b u i l d c o u l d c o n t a i n b u g s b u t m o s t o f t h e t i m e i s s a f e t o u s e . F o r a

m a n u a l i n s t a l l , y o u c a n d o w n l o a d t h e c u r r e n t b u i l d f r o m h t t p : / / b u i l d . r o c k b o x . o r g / .

A r c h i v e d B u i l d . I n a d d i t i o n t o t h e r e l e a s e v e r s i o n a n d t h e c u r r e n t b u i l d , t h e r e i s a l s o a n

a r c h i v e o f d a i l y b u i l d s a v a i l a b l e f o r d o w n l o a d . T h e s e a r e b u i l t o n c e a d a y f r o m t h e

l a t e s t s o u r c e c o d e i n t h e S V N r e p o s i t o r y . F o r a m a n u a l i n s t a l l , y o u c a n d o w n l o a d

a r c h i v e d b u i l d s f r o m h t t p : / / w w w . r o c k b o x . o r g / d a i l y . s h t m l .

N o t e : B e c a u s e c u r r e n t a n d a r c h i v e d b u i l d s a r e d e v e l o p m e n t v e r s i o n s t h a t c h a n g e f r e - bq u e n t l y , t h e y m a y b e h a v e d i e r e n t l y t h a n d e s c r i b e d i n t h i s m a n u a l , o r t h e y m a y i n t r o -

d u c e n e w ( a n d p o t e n t i a l l y a n n o y i n g ) b u g s . U n l e s s y o u w i s h t o t r y t h e l a t e s t a n d g r e a t e s t

f e a t u r e s a t t h e p r i c e o f p o s s i b l y g r e a t e r i n s t a b i l i t y , o r y o u w i s h t o h e l p w i t h d e v e l o p m e n t ,

y o u s h o u l d s t i c k w i t h t h e r e l e a s e .

P l e a s e n o w g o t o s e c t i o n 2 . 2 . 3 ( p a g e 1 5 ) t o c o m p l e t e t h e i n s t a l l a t i o n p r o c e d u r e .

2 . 2 . 2 . M a n u a l I n s t a l l a t i o n

T h e m a n u a l i n s t a l l a t i o n m e t h o d i s s t i l l a v a i l a b l e t o y o u , s h o u l d y o u n e e d o r d e s i r e i t b y

f o l l o w i n g t h e i n s t r u c t i o n s b e l o w . I f y o u h a v e u s e d R o c k b o x U t i l i t y t o i n s t a l l R o c k b o x ,

t h e n y o u d o n o t n e e d t o f o l l o w t h e n e x t s e c t i o n a n d c a n s k i p s t r a i g h t t o s e c t i o n 2 . 2 . 3

( p a g e 1 5 )

I n s t a l l i n g t h e r m w a r e

1 . D o w n l o a d y o u r c h o s e n v e r s i o n o f R o c k b o x f r o m t h e l i n k s i n t h e p r e v i o u s s e c t i o n .

2 . C o n n e c t y o u r p l a y e r t o t h e c o m p u t e r v i a U S B a s d e s c r i b e d i n t h e m a n u a l t h a t

c a m e w i t h y o u r p l a y e r .


http://www.rockbox.org/daily.shtml

http://build.rockbox.org/

http://www.rockbox.org/download/

http://www.rockbox.org/download/




3 . T a k e t h e . z i p l e t h a t y o u d o w n l o a d e d a n d u s e t h e E x t r a c t a l l c o m m a n d o f y o u r

u n z i p p r o g r a m t o e x t r a c t t h e l e s o n t o y o u r p l a y e r .

N o t e : T h e e n t i r e c o n t e n t s o f t h e . z i p

l e s h o u l d b e e x t r a c t e d d i r e c t l y t o t h e r o o t o f y o u r bp l a y e r ' s d r i v e . D o n o t t r y t o c r e a t e a s e p a r a t e d i r e c t o r y o n y o u r p l a y e r f o r t h e R o c k b o x

l e s ! T h e . z i p l e a l r e a d y c o n t a i n s t h e i n t e r n a l s t r u c t u r e t h a t R o c k b o x n e e d s .

I f t h e c o n t e n t s o f t h e . z i p l e a r e e x t r a c t e d c o r r e c t l y , y o u w i l l h a v e a d i r e c t o r y c a l l e d

. r o c k b o x , w h i c h c o n t a i n s a l l t h e l e s n e e d e d b y R o c k b o x , i n t h e m a i n d i r e c t o r y o f y o u r

p l a y e r ' s d r i v e .

I n s t a l l i n g t h e b o o t l o a d e r

• D o w n l o a d t h e R o c k b o x b o o t l o a d e r f r o m h t t p : / / d o w n l o a d . r o c k b o x . o r g / b o o t l o a d e r /

g i g a b e a t /

• S t a r t i n g a t t h e r o o t d i r e c t o r y o f y o u r p l a y e r b r o w s e i n t o t h e d i r e c t o r y G B S Y S T E M

a n d f r o m t h a t i n t o t h e s u b d i r e c t o r y F W I M G . T h e s e d i r e c t o r i e s a r e h i d d e n . M a k e

s u r e t h a t y o u h a v e c o n g u r e d y o u r b r o w s e r t o s h o w h i d d e n l e s o r y o u m a y b e

u n a b l e t o s e e F W I M G

.

• I n t h a t d i r e c t o r y y o u ' l l n d a l e c a l l e d F W I M G 0 1 . D A T . T h i s t o o m a y b e h i d d e n .

R e n a m e t h e l e t o F W I M G 0 1 . D A T . O R I G . M a k e s u r e y o u s p e l l e d t h a t n a m e c o r r e c t l y

a s i t i s n e e d e d f o r b o o t i n g t h e T o s h i b a r m w a r e .

W a r n i n g : I f y o u d o n o t c o m p l e t e t h i s s t e p t h e n y o u w i l l b e u n a b l e t o u n i n s t a l l !R o c k b o x w i t h o u t a c o p y o f t h e o r i g i n a l r m w a r e f r o m t h e o r i g i n a l i n s t a l l C D .

• N o w c o p y t h e l e F W I M G 0 1 . D A T y o u d o w n l o a d e d t o t h a t d i r e c t o r y . M a k e s u r e t h e

s p e l l i n g i s c o r r e c t .

2 . 2 . 3 . F i n i s h i n g t h e i n s t a l l

A f t e r i n s t a l l i n g y o u n e e d t o p o w e r - c y c l e t h e p l a y e r b y d o i n g t h e f o l l o w i n g s t e p s . F a i l u r e

t o d o s o m a y r e s u l t i n p r o b l e m s .

• S a f e l y e j e c t / u n m o u n t y o u r p l a y e r a n d u n p l u g t h e U S B c a b l e .

• U n p l u g a n y p o w e r a d a p t e r .

• H o l d t h e P o w e r b u t t o n t o t u r n o t h e p l a y e r .

• S l i d e t h e b a t t e r y s w i t c h l o c a t e d o n t h e b o t t o m o f t h e p l a y e r f r o m ` o n ' t o ` o ' .

• S l i d e t h e b a t t e r y s w i t c h b a c k f r o m ` o ' t o ` o n ' .


http://download.rockbox.org/bootloader/gigabeat/

http://download.rockbox.org/bootloader/gigabeat/




2 . 2 . 4 . E n a b l i n g S p e e c h S u p p o r t ( o p t i o n a l )

I f y o u w i s h t o u s e s p e e c h s u p p o r t y o u w i l l a l s o n e e d a v o i c e l e . V o i c e l e s a l l o w R o c k b o x

t o s p e a k t h e u s e r i n t e r f a c e t o y o u . R o c k b o x U t i l i t y c a n i n s t a l l a n E n g l i s h v o i c e l e , o r

y o u c a n d o w n l o a d i t f r o m h t t p : / / w w w . r o c k b o x . o r g / d a i l y . s h t m l a n d u n z i p i t t o t h e r o o t

o f y o u r p l a y e r . R o c k b o x U t i l i t y c a n a l s o a i d y o u i n t h e c r e a t i o n o f v o i c e l e s w i t h

d i e r e n t v o i c e s o r i n o t h e r l a n g u a g e s i f y o u h a v e a s u i t a b l e s p e e c h e n g i n e i n s t a l l e d o n

y o u r c o m p u t e r . V o i c e m e n u s a r e e n a b l e d b y d e f a u l t a n d w i l l c o m e i n t o e e c t a f t e r a

r e b o o t . S e e s e c t i o n 8 . 8 ( p a g e 7 0 ) f o r d e t a i l s o n v o i c e s e t t i n g s . R o c k b o x U t i l i t y c a n a l s o

a i d i n t h e p r o d u c t i o n o f t a l k l e s , w h i c h a l l o w R o c k b o x t o s p e a k l e a n d f o l d e r n a m e s .

2 . 3 . R u n n i n g R o c k b o x

W h e n y o u t u r n t h e u n i t o n , R o c k b o x s h o u l d l o a d .

2 . 4 . U p d a t i n g R o c k b o x

R o c k b o x c a n b e e a s i l y u p d a t e d w i t h R o c k b o x U t i l i t y . Y o u c a n a l s o u p d a t e R o c k b o x

m a n u a l l y d o w n l o a d a R o c k b o x b u i l d a s d e t a i l e d a b o v e , a n d u n z i p t h e b u i l d t o t h e r o o t

d i r e c t o r y o f y o u r p l a y e r a s i n t h e m a n u a l i n s t a l l a t i o n s t a g e . I f y o u r u n z i p p r o g r a m a s k s

y o u w h e t h e r t o o v e r w r i t e l e s , c h o o s e t h e Y e s t o a l l o p t i o n . T h e n e w b u i l d w i l l b e

i n s t a l l e d o v e r y o u r c u r r e n t b u i l d .

T h e b o o t l o a d e r o n l y c h a n g e s r a r e l y , a n d s h o u l d n o t n o r m a l l y n e e d t o b e u p d a t e d .

N o t e : I f y o u u s e R o c k b o x U t i l i t y b e a w a r e t h a t i t c a n n o t d e t e c t m a n u a l l y i n s t a l l e d

bc o m p o n e n t s .

2 . 5 . U n i n s t a l l i n g R o c k b o x

2 . 5 . 1 . A u t o m a t i c U n i n s t a l l a t i o n

Y o u c a n u n i n s t a l l R o c k b o x a u t o m a t i c a l l y b y u s i n g R o c k b o x U t i l i t y . I f y o u i n s t a l l e d

R o c k b o x m a n u a l l y y o u c a n s t i l l u s e R o c k b o x U t i l i t y f o r u n i n s t a l l a t i o n b u t w i l l n o t b e

a b l e t o d o t h i s s e l e c t i v e l y .

2 . 5 . 2 . M a n u a l U n i n s t a l l a t i o n

I f y o u w i s h t o c l e a n u p y o u r d i s k , y o u m a y a l s o w i s h t o d e l e t e t h e . r o c k b o x d i r e c t o r y

a n d i t s c o n t e n t s . T u r n t h e T o s h i b a o . T u r n t h e p l a y e r b a c k o n a n d t h e o r i g i n a l T o s h i b a

s o f t w a r e w i l l l o a d .






2 . 6 . T r o u b l e s h o o t i n g

F i l e N o t F o u n d I f y o u r e c e i v e a F i l e N o t F o u n d f r o m t h e b o o t l o a d e r , t h e n t h e b o o t -

l o a d e r c a n n o t n d t h e R o c k b o x r m w a r e . T h i s i s u s u a l l y a r e s u l t o f n o t e x t r a c t i n g

t h e c o n t e n t s o f t h e . z i p l e t o t h e p r o p e r l o c a t i o n , a n d s h o u l d n o t h a p p e n w h e n

R o c k b o x h a s b e e n i n s t a l l e d w i t h R o c k b o x U t i l i t y .

T o x t h i s , e i t h e r i n s t a l l R o c k b o x w i t h t h e R o c k b o x U t i l i t y w h i c h w i l l t a k e c a r e o f

t h i s f o r y o u , o r r e c h e c k t h e M a n u a l I n s t a l l s e c t i o n t o s e e w h e r e t h e l e s n e e d t o b e

l o c a t e d .




C h a p t e r 3 . Q u i c k S t a r t 1 8

3 . Q u i c k S t a r t

3 . 1 . B a s i c O v e r v i e w

3 . 1 . 1 . T h e p l a y e r ' s c o n t r o l s

T h r o u g h o u t t h i s m a n u a l , t h e b u t t o n s o n t h e p l a y e r a r e l a b e l l e d a c c o r d i n g t o t h e p i c t u r e

a b o v e . W h e n e v e r a b u t t o n n a m e i s p r e x e d b y L o n g , a l o n g p r e s s o f a p p r o x i m a t e l y o n e

s e c o n d s h o u l d b e p e r f o r m e d o n t h a t b u t t o n . T h e b u t t o n s a r e d e s c r i b e d i n d e t a i l i n t h e

f o l l o w i n g p a r a g r a p h . A d d i t i o n a l i n f o r m a t i o n f o r b l i n d u s e r s i s a v a i l a b l e o n t h e R o c k b o x ¸w e b s i t e a t ZB l i n d F A Q .

N o t e : T h e f o l l o w i n g d e s c r i p t i o n i s f o r t h e G i g a b e a t F , b u t c a n a l s o a p p l y f o r t h e G i g a b e a t bX . T h e G i g a b e a t F i s s l i g h t l y l a r g e r a n d m o r e r e c t a n g u l a r s h a p e d , w h i l e t h e G i g a b e a t X

i s s m a l l e r a n d h a s a s l i g h t l y t a p e r e d b a c k .

H o l d t h e p l a y e r w i t h t h e s c r e e n o n t o p a n d t h e c o n t r o l s o n t h e r i g h t h a n d s i d e . B e l o w

t h e s c r e e n i s a c r o s s - s h a p e d t o u c h s e n s i t i v e p a d w h i c h c o n t a i n s t h e U p , D o w n , L e f t a n d

R i g h t c o n t r o l s . O n t h e G i g a b e a t X , t h i s p a d w i l l f e e l s l i g h t l y r a i s e d u p , w h i l e i t w i l l f e e l

s l i g h t l y s u n k e n i n o n t h e G i g a b e a t F . O n t h e t o p o f t h e u n i t , f r o m l e f t t o r i g h t , a r e t h e

p o w e r s o c k e t , t h e H o l d s w i t c h , a n d t h e h e a d p h o n e s o c k e t . T h e H o l d s w i t c h p u t s t h e

p l a y e r i n t o h o l d m o d e w h e n i t i s s w i t c h e d t o t h e r i g h t o f t h e u n i t . T h e b u t t o n s w i l l h a v e

n o e e c t w h e n t h i s i s t h e c a s e .


http://www.rockbox.org/wiki/BlindFAQ




S t a r t i n g f r o m t h e l e f t h a n d s i d e o n t h e b o t t o m o f t h e u n i t , n e a r e r t o t h e f r o n t t h a n

t h e b a c k , i s a r e c e s s e d s w i t c h w h i c h c o n t r o l s w h e t h e r t h e b a t t e r y i s o n o r o . W h e n t h i s

s w i t c h i s t o t h e l e f t , t h e b a t t e r y i s d i s c o n n e c t e d . T h i s c a n b e u s e d f o r a h a r d r e s e t o f

t h e u n i t , o r i f t h e p l a y e r i s b e i n g p l a c e d i n s t o r a g e . N e x t t o t h a t i s a c o n n e c t o r f o r t h e

d o c k i n g s t a t i o n a n d n a l l y o n t h e r i g h t h a n d s i d e o f t h e b o t t o m o f t h e u n i t i s a m i n i

U S B s o c k e t f o r c o n n e c t i n g d i r e c t l y t o U S B .

F i n a l l y o n t h e r i g h t h a n d s i d e o f t h e u n i t a r e s o m e c o n t r o l b u t t o n s . G o i n g f r o m t h e

b o t t o m o f t h e u n i t t o t h e t o p t h e r e i s a s m a l l r o u n d A b u t t t o n t h e n a r o c k e r v o l u m e

s w i t c h w i t h o f t h e V o l u m e d o w n b u t t o n b e l o w t h e V o l u m e u p b u t t o n . A b o v e t h a t

i s a r e t w o m o r e s m a l l r o u n d b u t t o n s , t h e M e n u b u t t o n a n d n e a r e s t t o t h e t o p o f t h e

u n i t t h e P o w e r b u t t o n , w h i c h i s h e l d d o w n t o t u r n t h e p l a y e r o n o r o . I f y o u h a v e a

G i g a b e a t X , t h e s e b u t t o n s a r e s m a l l m e t a l l i c b u t t o n s t h a t a r e p l a c e f u r t h e r u p o n t h e

r i g h t h a n d s i d e , a n d c l o s e r t o g e t h e r . T h e l a y o u t i s s t i l l t h e s a m e , h o w e v e r .

3 . 1 . 2 . T u r n i n g t h e p l a y e r o n a n d o

T o t u r n o n a n d o y o u r R o c k b o x e n a b l e d p l a y e r u s e t h e f o l l o w i n g k e y s :

K e y R e m o t e K e y A c t i o n

P o w e r S t a r t R o c k b o x

L o n g P o w e r S h u t d o w n R o c k b o x

O n s h u t d o w n , R o c k b o x a u t o m a t i c a l l y s a v e s i t s s e t t i n g s .

I f y o u h a v e p r o b l e m s w i t h y o u r s e t t i n g s , s u c h a s a c c i d e n t a l l y h a v i n g s e t t h e c o l o u r s t o

b l a c k o n b l a c k , t h e y c a n b e r e s e t a t b o o t t i m e . S e e t h e R e s e t S e t t i n g s i n s e c t i o n 1 1 . 3 . 3

( p a g e 1 7 7 ) f o r d e t a i l s .

I n t h e u n l i k e l y e v e n t o f a s o f t w a r e f a i l u r e , h a r d w a r e p o w e r o o r r e s e t c a n b e p e r f o r m e d

b y h o l d i n g d o w n t h e b a t t e r y s w i t c h u n t i l t h e p l a y e r s h u t s o o r r e b o o t s .

3 . 1 . 3 . P u t t i n g m u s i c o n y o u r p l a y e r

W i t h t h e p l a y e r c o n n e c t e d t o t h e c o m p u t e r a s a n M S C / U M S d e v i c e ( l i k e a U S B D r i v e ) ,

m u s i c l e s c a n b e p u t o n t h e p l a y e r v i a a n y s t a n d a r d l e t r a n s f e r m e t h o d t h a t y o u w o u l d

u s e t o c o p y l e s b e t w e e n d r i v e s ( e . g . D r a g - a n d - D r o p ) . F i l e s m a y b e p l a c e d w h e r e v e r

y o u l i k e o n t h e p l a y e r , b u t i t i s s t r o n g l y s u g g e s t e d n o t t o p l a c e t h e m i n t h e / . r o c k b o x

f o l d e r . T h e d e f a u l t d i r e c t o r y s t r u c t u r e t h a t i s a s s u m e d b y s o m e p a r t s o f R o c k b o x ( a l b u m

a r t s e a r c h i n g , a n d m i s s i n g - t a g f a l l b a c k i n s o m e W P S e s ) u s e s t h e p a r e n t d i r e c t o r y o f a

s o n g a s t h e A l b u m n a m e , a n d t h e p a r e n t d i r e c t o r y o f t h a t f o l d e r a s t h e A r t i s t n a m e .

W P S e s m a y d i s p l a y i n f o r m a t i o n i n c o r r e c t l y i f y o u r l e s a r e n o t p r o p e r l y t a g g e d , a n d

y o u h a v e y o u r m u s i c o r g a n i z e d i n a w a y d i e r e n t t h a n t h e y a s s u m e w h e n a t t e m p t i n g t o

g u e s s t h e A r t i s t a n d A l b u m n a m e s f r o m y o u r l e t r e e . S e e s e c t i o n B . 2 1 ( p a g e 1 9 3 ) f o r

t h e r e q u i r e m e n t s f o r A l b u m A r t t o w o r k p r o p e r l y . S e e s e c t i o n A . 2 ( p a g e 1 8 2 ) f o r a l i s t

o f s u p p o r t e d a u d i o f o r m a t s .





3 . 1 . 4 . T h e r s t c o n t a c t

A f t e r y o u h a v e r s t s t a r t e d t h e p l a y e r , y o u ' l l b e p r e s e n t e d b y t h e M a i n M e n u . F r o m

t h i s m e n u y o u c a n r e a c h e v e r y f u n c t i o n o f R o c k b o x , f o r m o r e i n f o r m a t i o n ( s e e s e c t i o n 5 . 1

( p a g e 4 1 ) ) . T o b r o w s e t h e l e s o n y o u r p l a y e r , s e l e c t F i l e s ( s e e s e c t i o n 4 . 1 ( p a g e 2 2 ) ) ,

a n d t o b r o w s e i n a v i e w t h a t i s b a s e d o n t h e m e t a - d a t a

1

o f y o u r a u d i o l e s , s e l e c t

D a t a b a s e ( s e e s e c t i o n 4 . 2 ( p a g e 2 7 ) ) .

3 . 1 . 5 . B a s i c c o n t r o l s

W h e n b r o w s i n g l e s a n d m o v i n g t h r o u g h m e n u s y o u u s u a l l y g e t a l i s t v i e w p r e s e n t e d .

T h e n a v i g a t i o n i n t h e s e l i s t s a r e u s u a l l y t h e s a m e a n d s h o u l d b e p r e t t y i n t u i t i v e . I n t h e

t r e e v i e w u s e D o w n a n d U p t o m o v e a r o u n d t h e s e l e c t i o n . U s e S e l e c t o r R i g h t t o

s e l e c t a n i t e m . W h e n b r o w s i n g t h e l e s y s t e m s e l e c t i n g a n a u d i o l e p l a y s i t . T h e v i e w

s w i t c h e s t o t h e W h i l e p l a y i n g s c r e e n , u s u a l l y a b b r e v i a t e d a s W P S ( s e e s e c t i o n 4 . 3

( p a g e 3 0 ) . T h e d y n a m i c p l a y l i s t g e t s r e p l a c e d w i t h t h e c o n t e n t s o f t h e c u r r e n t d i r e c t o r y .

T h i s w a y y o u c a n e a s i l y t r e a t d i r e c t o r i e s a s p l a y l i s t s . T h e c r e a t e d d y n a m i c p l a y l i s t c a n

b e e x t e n d e d o r m o d i e d w h i l e p l a y i n g . T h i s i s a l s o k n o w n a s o n - t h e - y p l a y l i s t . T o g o

b a c k t o t h e F i l e B r o w s e r s t o p t h e p l a y b a c k w i t h t h e P o w e r b u t t o n o r r e t u r n t o t h e

l e b r o w s e r w h i l e k e e p i n g p l a y b a c k r u n n i n g u s i n g S e l e c t . I n l i s t v i e w s y o u c a n g o b a c k

o n e s t e p w i t h L e f t .

3 . 1 . 6 . B a s i c c o n c e p t s

P l a y l i s t s

R o c k b o x i s p l a y l i s t o r i e n t e d . T h i s m e a n s t h a t e v e r y t i m e y o u p l a y a n a u d i o l e , a s o -

c a l l e d d y n a m i c p l a y l i s t i s g e n e r a t e d , u n l e s s y o u p l a y a s a v e d p l a y l i s t . Y o u c a n m o d i f y

t h e d y n a m i c p l a y l i s t w h i l e p l a y i n g a n d a l s o s a v e i t t o a l e . I f y o u d o n o t w a n t t o u s e

p l a y l i s t s y o u c a n s i m p l y p l a y y o u r l e s d i r e c t o r y b a s e d . P l a y l i s t s a r e c o v e r e d i n d e t a i l i n

s e c t i o n 4 . 4 ( p a g e 3 5 ) .

M e n u

F r o m t h e m e n u y o u c a n c u s t o m i s e R o c k b o x . R o c k b o x i t s e l f i s v e r y c u s t o m i s a b l e . A l s o

t h e r e a r e s o m e s p e c i a l m e n u s f o r q u i c k a c c e s s t o f r e q u e n t l y u s e d f u n c t i o n s .

C o n t e x t M e n u

S o m e v i e w s , e s p e c i a l l y t h e l e b r o w s e r a n d t h e W P S h a v e a c o n t e x t m e n u . F r o m t h e

l e b r o w s e r t h i s c a n b e a c c e s s e d w i t h L o n g S e l e c t . T h e c o n t e n t s o f t h e c o n t e x t m e n u

v a r y , d e p e n d i n g o n t h e s i t u a t i o n i t g e t s c a l l e d . T h e c o n t e x t m e n u i t s e l f p r e s e n t s y o u w i t h

s o m e o p e r a t i o n s y o u c a n p e r f o r m w i t h t h e c u r r e n t l y h i g h l i g h t e d l e . I n t h e l e b r o w s e r

t h i s i s t h e l e ( o r d i r e c t o r y ) t h a t i s h i g h l i g h t e d b y t h e c u r s o r . F r o m t h e W P S t h i s i s

1

I D 3 T a g s , V o r b i s c o m m e n t s , e t c .





t h e c u r r e n t l y p l a y i n g l e . A l s o t h e r e a r e s o m e a c t i o n s t h a t d o n o t a p p l y t o t h e c u r r e n t

l e b u t r e f e r t o t h e s c r e e n f r o m w h i c h t h e c o n t e x t m e n u g e t s c a l l e d . O n e e x a m p l e i s t h e

p l a y b a c k m e n u , w h i c h c a n b e c a l l e d u s i n g t h e c o n t e x t m e n u f r o m w i t h i n t h e W P S .

3 . 2 . C u s t o m i s i n g R o c k b o x

R o c k b o x ' U s e r I n t e r f a c e c a n b e c u s t o m i s e d u s i n g T h e m e s . T h e m e s u s u a l l y o n l y a e c t

t h e v i s u a l a p p e a r a n c e , b u t a n a d v a n c e d u s e r c a n c r e a t e a t h e m e t h a t a l s o c h a n g e s v a r i o u s

o t h e r s e t t i n g s l i k e l e v i e w , L C D s e t t i n g s a n d a l l o t h e r s e t t i n g s t h a t c a n b e m o d i e d u s i n g

. c f g l e s . T h i s t o p i c i s d i s c u s s e d i n m o r e d e t a i l i n s e c t i o n 1 1 . 3 ( p a g e 1 7 5 ) . T h e R o c k b o x

d i s t r i b u t i o n c o m e s w i t h s o m e t h e m e s t h a t s h o u l d l o o k n i c e o n y o u r p l a y e r .

N o t e : S o m e o f t h e t h e m e s s h i p p e d w i t h R o c k b o x n e e d a d d i t i o n a l f o n t s f r o m t h e f o n t s bp a c k a g e , s o m a k e s u r e y o u i n s t a l l e d t h e m . A l s o , i f y o u d o w n l o a d e d a d d i t i o n a l t h e m e s

f r o m t h e I n t e r n e t m a k e s u r e y o u h a v e t h e n e e d e d f o n t s i n s t a l l e d a s o t h e r w i s e t h e t h e m e

m a y n o t d i s p l a y p r o p e r l y .

3 . 3 . U S B C h a r g i n g

T o c h a r g e y o u r p l a y e r o v e r U S B , h o l d M e n u w h i l e p l u g g i n g i t i n . T h i s w i l l p r e v e n t i t

f r o m c o n n e c t i n g t o y o u r c o m p u t e r a n d l e t y o u c o n t i n u e t o u s e i t n o r m a l l y . Y o u r p l a y e r

m u s t a l r e a d y b e i n R o c k b o x f o r t h i s t o f u n c t i o n .




C h a p t e r 4 . B r o w s i n g a n d p l a y i n g 2 2

4 . B r o w s i n g a n d p l a y i n g

4 . 1 . F i l e B r o w s e r

F i g u r e 4 . 1 . : T h e l e b r o w s e r

R o c k b o x l e t s y o u b r o w s e y o u r m u s i c i n e i t h e r o f t w o w a y s . T h e F i l e B r o w s e r l e t s

y o u n a v i g a t e t h r o u g h t h e l e s a n d d i r e c t o r i e s o n y o u r p l a y e r , e n t e r i n g d i r e c t o r i e s a n d

e x e c u t i n g t h e d e f a u l t a c t i o n o n e a c h l e . T o h e l p d i e r e n t i a t e l e s , e a c h l e f o r m a t i s

d i s p l a y e d w i t h a n i c o n .

T h e D a t a b a s e B r o w s e r , o n t h e o t h e r h a n d , a l l o w s y o u t o n a v i g a t e t h r o u g h t h e

m u s i c o n y o u r p l a y e r u s i n g c a t e g o r i e s l i k e a l b u m , a r t i s t , g e n r e , e t c .

Y o u c a n s e l e c t w h e t h e r t o b r o w s e u s i n g t h e F i l e B r o w s e r o r t h e D a t a b a s e B r o w s e r

b y s e l e c t i n g e i t h e r F i l e s o r D a t a b a s e i n t h e M a i n M e n u . I f y o u c h o o s e t h e F i l e

B r o w s e r , t h e S h o w F i l e s s e t t i n g l e t s y o u s e l e c t w h a t t y p e s o f l e s y o u w i s h t o v i e w .

S e e s e c t i o n 8 . 2 ( p a g e 6 2 ) f o r m o r e i n f o r m a t i o n o n t h e S h o w F i l e s s e t t i n g .

N o t e : T h e F i l e B r o w s e r a l l o w s y o u t o m a n i p u l a t e y o u r l e s i n w a y s t h a t a r e n o t ba v a i l a b l e w i t h i n t h e D a t a b a s e B r o w s e r . R e a d m o r e a b o u t D a t a b a s e i n s e c t i o n 4 . 2

( p a g e 2 7 ) . T h e r e m a i n d e r o f t h i s s e c t i o n d e a l s w i t h t h e F i l e B r o w s e r .





4 . 1 . 1 . F i l e B r o w s e r C o n t r o l s


U p / D o w n V o l u m e

U p / V o l u m e

D o w n

G o t o p r e v i o u s / n e x t i t e m i n l i s t . I f y o u

a r e o n t h e r s t / l a s t e n t r y , t h e c u r s o r w i l l

w r a p t o t h e l a s t / r s t e n t r y .

L e f t R e w i n d G o t o t h e p a r e n t d i r e c t o r y .

S e l e c t o r R i g h t F o r w a r d E x e c u t e t h e d e f a u l t a c t i o n o n t h e s e l e c t e d

l e o r e n t e r a d i r e c t o r y .

A P l a y I f t h e r e i s a n a u d i o l e p l a y i n g , r e t u r n

t o t h e W h i l e P l a y i n g S c r e e n ( W P S )

w i t h o u t s t o p p i n g p l a y b a c k .

P o w e r L o n g P l a y S t o p a u d i o p l a y b a c k .

L o n g S e l e c t L o n g M e n u E n t e r t h e C o n t e x t M e n u .

M e n u M e n u E n t e r t h e M a i n M e n u .

L o n g M e n u L o n g R e w i n d S w i t c h t o t h e Q u i c k S c r e e n ( s e e s e c -

t i o n 5 . 1 1 ( p a g e 4 6 ) ) .

A + M e n u A c t i v a t e t h e H o t k e y f u n c t i o n ( s e e s e c -

t i o n 4 . 5 ( p a g e 4 0 ) ) .





4 . 1 . 2 . C o n t e x t M e n u

F i g u r e 4 . 2 . : T h e C o n t e x t M e n u

T h e C o n t e x t M e n u a l l o w s y o u t o p e r f o r m c e r t a i n o p e r a t i o n s o n l e s o r d i r e c t o r i e s . T o

a c c e s s t h e C o n t e x t M e n u , p o s i t i o n t h e s e l e c t o r o v e r a l e o r d i r e c t o r y a n d a c c e s s t h e

c o n t e x t m e n u w i t h L o n g S e l e c t .

N o t e : T h e C o n t e x t M e n u i s a c o n t e x t s e n s i t i v e m e n u . I f t h e C o n t e x t M e n u i s bi n v o k e d o n a l e , i t w i l l d i s p l a y o p t i o n s a v a i l a b l e f o r l e s . I f t h e C o n t e x t M e n u i s

i n v o k e d o n a d i r e c t o r y , i t w i l l d i s p l a y o p t i o n s f o r d i r e c t o r i e s .

T h e C o n t e x t M e n u c o n t a i n s t h e f o l l o w i n g o p t i o n s ( u n l e s s o t h e r w i s e n o t e d , e a c h

o p t i o n p e r t a i n s b o t h t o l e s a n d d i r e c t o r i e s ) :

P l a y l i s t . E n t e r s t h e P l a y l i s t S u b m e n u ( s e e s e c t i o n 4 . 4 . 3 ( p a g e 3 7 ) ) .

P l a y l i s t C a t a l o g . E n t e r s t h e P l a y l i s t C a t a l o g S u b m e n u ( s e e s e c t i o n 4 . 4 . 2 ( p a g e 3 6 ) ) .

R e n a m e . T h i s f u n c t i o n l e t s t h e u s e r m o d i f y t h e n a m e o f a l e o r d i r e c t o r y .

C u t . C o p i e s t h e n a m e o f t h e c u r r e n t l y s e l e c t e d l e o r d i r e c t o r y t o t h e c l i p b o a r d a n d

m a r k s i t t o b e ` c u t ' .

C o p y . C o p i e s t h e n a m e o f t h e c u r r e n t l y s e l e c t e d l e o r d i r e c t o r y t o t h e c l i p b o a r d a n d

m a r k s i t t o b e ` c o p i e d ' .





P a s t e . O n l y v i s i b l e i f a l e o r d i r e c t o r y n a m e i s o n t h e c l i p b o a r d . W h e n s e l e c t e d i t w i l l

m o v e o r c o p y t h e c l i p b o a r d t o t h e c u r r e n t d i r e c t o r y .

D e l e t e . D e l e t e s t h e c u r r e n t l y s e l e c t e d l e . T h i s o p t i o n a p p l i e s o n l y t o l e s , a n d n o t t o

d i r e c t o r i e s . R o c k b o x w i l l a s k f o r c o n r m a t i o n b e f o r e d e l e t i n g a l e . P r e s s S e l e c t

t o c o n r m d e l e t i o n o r a n y o t h e r k e y t o c a n c e l .

D e l e t e D i r e c t o r y . D e l e t e s t h e c u r r e n t l y s e l e c t e d d i r e c t o r y a n d a l l o f t h e l e s a n d s u b d i -

r e c t o r i e s i t m a y c o n t a i n . D e l e t e d d i r e c t o r i e s c a n n o t b e r e c o v e r e d . U s e t h i s f e a t u r e

w i t h c a u t i o n !

S e t A s B a c k d r o p . S e t t h e s e l e c t e d b m p l e a s b a c k g r o u n d i m a g e . T h e b i t m a p s n e e d t o

m e e t t h e c o n d i t i o n s e x p l a i n e d i n s e c t i o n 1 1 . 1 . 5 ( p a g e 1 6 9 ) .

O p e n w i t h . R u n s a v i e w e r p l u g i n o n t h e l e . N o r m a l l y , w h e n a l e i s s e l e c t e d i n R o c k -

b o x , R o c k b o x a u t o m a t i c a l l y d e t e c t s t h e l e t y p e a n d r u n s t h e a p p r o p r i a t e p l u g i n .

T h e O p e n W i t h f u n c t i o n c a n b e u s e d t o o v e r r i d e t h e d e f a u l t a c t i o n a n d s e l e c t a

v i e w e r b y h a n d . F o r e x a m p l e , t h i s f u n c t i o n c a n b e u s e d t o v i e w a t e x t l e e v e n i f

t h e l e h a s a n o n - s t a n d a r d e x t e n s i o n ( i . e . , t h e l e h a s a n e x t e n s i o n o f s o m e t h i n g

o t h e r t h a n . t x t ) . S e e s e c t i o n 1 0 . 3 ( p a g e 1 2 7 ) f o r m o r e d e t a i l s o n v i e w e r s .

C r e a t e D i r e c t o r y . C r e a t e a n e w d i r e c t o r y i n t h e c u r r e n t d i r e c t o r y o n t h e d i s k .

P r o p e r t i e s . S h o w s p r o p e r t i e s s u c h a s s i z e a n d t h e t i m e a n d d a t e o f t h e l a s t m o d i c a t i o n

f o r t h e s e l e c t e d l e . I f u s e d o n a d i r e c t o r y , t h e n u m b e r o f l e s a n d s u b d i r e c t o r i e s

w i l l b e s h o w n , a s w e l l a s t h e t o t a l s i z e .

A d d t o S h o r t c u t s . A d d s a l i n k t o t h e s e l e c t e d i t e m i n t h e s h o r t c u t s . l i n k l e . I f t h e

l e d o e s n o t a l r e a d y e x i s t i t w i l l b e c r e a t e d i n t h e r o o t d i r e c t o r y . N o t e t h a t i f y o u

c r e a t e a s h o r t c u t t o a l e , R o c k b o x w i l l n o t o p e n i t u p o n s e l e c t i n g , b u t s i m p l y

b r i n g y o u t o i t ' s l o c a t i o n i n t h e F i l e B r o w s e r .





4 . 1 . 3 . V i r t u a l K e y b o a r d

F i g u r e 4 . 3 . : T h e v i r t u a l k e y b o a r d

T h i s i s t h e v i r t u a l k e y b o a r d t h a t i s u s e d w h e n e n t e r i n g t e x t i n R o c k b o x , f o r e x a m p l e

w h e n r e n a m i n g a l e o r c r e a t i n g a n e w d i r e c t o r y . T h e v i r t u a l k e y b o a r d c a n b e e a s i l y

c h a n g e d b y m a k i n g a t e x t l e w i t h t h e r e q u i r e d l a y o u t . M o r e i n f o r m a t i o n o n h o w t o

a c h i e v e t h i s c a n b e f o u n d o n t h e R o c k b o x w e b s i t e a t ZL o a d a b l e K e y b o a r d L a y o u t s .

A l s o y o u c a n s w i t c h t o M o r s e c o d e i n p u t m o d e b y c h a n g i n g t h e U s e M o r s e C o d e

I n p u t s e t t i n g o r b y p r e s s i n g A + P o w e r i n t h e v i r t u a l k e y b o a r d .

N o t e : W h e n t h e c u r s o r i s o n t h e i n p u t l i n e , S e l e c t d e l e t e s t h e p r e c e d i n g c h a r a c t e r b


http://www.rockbox.org/wiki/LoadableKeyboardLayouts





A + L e f t / A +

R i g h t

/ M o v e t h e l i n e c u r s o r w i t h i n t h e t e x t l i n e .

M e n u D e l e t e t h e c h a r a c t e r b e f o r e t h e l i n e c u r -

s o r .

L e f t / R i g h t / M o v e t h e c u r s o r o n t h e v i r t u a l k e y b o a r d .

I f y o u m o v e o u t o f t h e p i c k e r a r e a , y o u

g e t t h e p r e v i o u s / n e x t p a g e o f c h a r a c t e r s

( i f t h e r e i s m o r e t h a n o n e ) .

U p / D o w n / M o v e t h e c u r s o r o n t h e v i r t u a l k e y b o a r d .

I f y o u m o v e o u t o f t h e p i c k e r a r e a y o u g e t

t o t h e l i n e e d i t m o d e .

A + M e n u F l i p t o t h e n e x t p a g e o f c h a r a c t e r s ( i f

t h e r e i s m o r e t h a n o n e ) .

S e l e c t I n s e r t t h e s e l e c t e d k e y b o a r d l e t t e r a t t h e

c u r r e n t l i n e c u r s o r p o s i t i o n .

A E x i t t h e v i r t u a l k e y b o a r d a n d s a v e a n y

c h a n g e s .

P o w e r E x i t t h e v i r t u a l k e y b o a r d w i t h o u t s a v i n g

a n y c h a n g e s .

A + P o w e r T o g g l e k e y b o a r d i n p u t m o d e a n d M o r s e

c o d e i n p u t m o d e .

S e l e c t T a p t o s e l e c t a c h a r a c t e r i n M o r s e c o d e

i n p u t m o d e .

4 . 2 . D a t a b a s e

4 . 2 . 1 . I n t r o d u c t i o n

T h i s c h a p t e r d e s c r i b e s t h e R o c k b o x m u s i c d a t a b a s e s y s t e m . U s i n g t h e i n f o r m a t i o n c o n -

t a i n e d i n t h e t a g s ( I D 3 v 1 , I D 3 v 2 , V o r b i s C o m m e n t s , A p e v 2 , e t c . ) i n y o u r a u d i o l e s ,

R o c k b o x b u i l d s a n d m a i n t a i n s a d a t a b a s e o f t h e m u s i c l e s o n y o u r p l a y e r a n d a l l o w s

y o u t o b r o w s e t h e m b y A r t i s t , A l b u m , G e n r e , S o n g N a m e , e t c . T h e c r i t e r i a t h e d a t a b a s e

u s e s t o s o r t t h e s o n g s c a n b e c o m p l e t e l y c u s t o m i s e d . M o r e i n f o r m a t i o n o n h o w t o a c h i e v e

t h i s c a n b e f o u n d o n t h e R o c k b o x w e b s i t e a t ZD a t a B a s e .

4 . 2 . 2 . I n i t i a l i z i n g t h e D a t a b a s e

T h e r s t t i m e y o u u s e t h e d a t a b a s e , R o c k b o x w i l l s c a n y o u r d i s k f o r a u d i o l e s . T h i s c a n

t a k e q u i t e a w h i l e d e p e n d i n g o n t h e n u m b e r o f l e s o n y o u r p l a y e r . T h i s s c a n h a p p e n s

i n t h e b a c k g r o u n d , s o y o u c a n c h o o s e t o r e t u r n t o t h e M a i n M e n u a n d c o n t i n u e t o l i s t e n

t o m u s i c . I f y o u s h u t d o w n y o u r p l a y e r , t h e s c a n w i l l c o n t i n u e n e x t t i m e y o u t u r n i t o n .


http://www.rockbox.org/wiki/DataBase




A f t e r t h e s c a n i s n i s h e d y o u m a y b e p r o m p t e d t o r e s t a r t y o u r p l a y e r b e f o r e y o u c a n u s e

t h e d a t a b a s e .

I g n o r i n g D i r e c t o r i e s D u r i n g D a t a b a s e I n i t i a l i z a t i o n

Y o u m a y h a v e d i r e c t o r i e s o n y o u r p l a y e r w h o s e c o n t e n t s s h o u l d n o t b e a d d e d t o t h e

d a t a b a s e . P l a c i n g a l e n a m e d d a t a b a s e . i g n o r e i n a d i r e c t o r y w i l l e x c l u d e t h e l e s i n

t h a t d i r e c t o r y a n d a l l i t s s u b d i r e c t o r i e s f r o m s c a n n i n g t h e i r t a g s a n d a d d i n g t h e m t o t h e

d a t a b a s e . T h i s w i l l s p e e d u p t h e d a t a b a s e i n i t i a l i z a t i o n .

I f a s u b d i r e c t o r y o f a n ` i g n o r e d ' d i r e c t o r y s h o u l d s t i l l b e s c a n n e d , p l a c e a l e n a m e d

d a t a b a s e . u n i g n o r e i n i t . T h e l e s i n t h a t d i r e c t o r y a n d i t s s u b d i r e c t o r i e s w i l l b e s c a n n e d

a n d a d d e d t o t h e d a t a b a s e .

4 . 2 . 3 . T h e D a t a b a s e M e n u

L o a d T o R A M T h e d a t a b a s e c a n e i t h e r b e k e p t o n h a r d d i s k ( t o s a v e m e m o r y ) , o r

l o a d e d i n t o R A M ( f o r f a s t b r o w s i n g ) . S e t t i n g t h i s t o Y e s l o a d s t h e d a t a b a s e t o

R A M , a l l o w i n g f a s t e r b r o w s i n g a n d s e a r c h i n g . S e t t i n g t h i s o p t i o n t o N o k e e p s t h e

d a t a b a s e o n t h e h a r d d i s k , m e a n i n g s l o w e r b r o w s i n g b u t i t d o e s n o t u s e e x t r a R A M

a n d s a v e s s o m e b a t t e r y o n b o o t u p .

N o t e : I f y o u b r o w s e y o u r m u s i c f r e q u e n t l y u s i n g t h e d a t a b a s e , y o u s h o u l d l o a d t o bR A M , a s t h i s w i l l r e d u c e t h e o v e r a l l b a t t e r y c o n s u m p t i o n b e c a u s e t h e d i s k w i l l n o t

n e e d t o s p i n o n e a c h s e a r c h .

A u t o U p d a t e I f A u t o u p d a t e i s s e t t o o n , e a c h t i m e t h e p l a y e r b o o t s , t h e d a t a b a s e

w i l l a u t o m a t i c a l l y b e u p d a t e d .

I n i t i a l i z e N o w Y o u c a n f o r c e R o c k b o x t o r e s c a n y o u r d i s k f o r t a g g e d l e s b y u s i n g t h e

I n i t i a l i z e N o w f u n c t i o n i n t h e D a t a b a s e M e n u .

W a r n i n g : I n i t i a l i z e N o w r e m o v e s a l l d a t a b a s e l e s ( r e m o v i n g r u n t i m e d b d a t a !a l s o ) a n d r e b u i l d s t h e d a t a b a s e f r o m s c r a t c h .

U p d a t e N o w U p d a t e n o w c a u s e s t h e d a t a b a s e t o d e t e c t n e w a n d d e l e t e d l e s

N o t e : U n l i k e t h e A u t o U p d a t e f u n c t i o n , U p d a t e N o w w i l l u p d a t e t h e d a t a b a s e br e g a r d l e s s o f w h e t h e r t h e D i r e c t o r y C a c h e i s e n a b l e d . T h u s , a n u p d a t e u s i n g

U p d a t e n o w m a y t a k e a l o n g t i m e .

U n l i k e I n i t i a l i z e N o w , t h e U p d a t e N o w f u n c t i o n d o e s n o t r e m o v e r u n t i m e

d a t a b a s e i n f o r m a t i o n .

G a t h e r R u n t i m e D a t a W h e n e n a b l e d , r o c k b o x w i l l r e c o r d h o w o f t e n a n d h o w l o n g a

t r a c k i s b e i n g p l a y e d , w h e n i t w a s l a s t p l a y e d a n d i t s r a t i n g . T h i s i n f o r m a t i o n c a n

b e d i s p l a y e d i n t h e W P S a n d i s u s e d i n t h e d a t a b a s e b r o w s e r t o , f o r e x a m p l e , s h o w

t h e m o s t p l a y e d , u n p l a y e d a n d m o s t r e c e n t l y p l a y e d t r a c k s .





E x p o r t M o d i c a t i o n s T h i s a l l o w s f o r t h e r u n t i m e d a t a t o b e e x p o r t e d t o t h e l e

/ . r o c k b o x / d a t a b a s e _ c h a n g e l o g . t x t , w h i c h b a c k s u p t h e r u n t i m e d a t a i n A S C I I

f o r m a t . T h i s i s n e e d e d w h e n d a t a b a s e s t r u c t u r e s c h a n g e , b e c a u s e n e w c o d e c a n n o t

r e a d o l d d a t a b a s e c o d e . B u t , a l l m o d i c a t i o n s e x p o r t e d t o A S C I I f o r m a t s h o u l d

b e r e a d a b l e b y a l l d a t a b a s e v e r s i o n s .

I m p o r t M o d i c a t i o n s . A l l o w s t h e / . r o c k b o x / d a t a b a s e _ c h a n g e l o g . t x t b a c k u p t o b e

c o n v e n i e n t l y l o a d e d i n t o t h e d a t a b a s e . I f A u t o U p d a t e i s e n a b l e d t h i s i s p e r -

f o r m e d a u t o m a t i c a l l y w h e n t h e d a t a b a s e i s i n i t i a l i z e d .

4 . 2 . 4 . U s i n g t h e D a t a b a s e

O n c e t h e d a t a b a s e h a s b e e n i n i t i a l i z e d , y o u c a n b r o w s e y o u r m u s i c b y A r t i s t , A l b u m ,

G e n r e , S o n g N a m e , e t c . T o u s e t h e d a t a b a s e , g o t o t h e M a i n M e n u a n d s e l e c t D a t a b a s e .

N o t e : Y o u m a y n e e d t o i n c r e a s e t h e v a l u e o f t h e M a x f i l e s i n d i r b r o w s e r s e t t i n g

b( S e t t i n g s → G e n e r a l S e t t i n g s → S y s t e m → L i m i t s ) i n o r d e r t o v i e w l o n g l i s t s

o f t r a c k s i n t h e I D 3 d a t a b a s e b r o w s e r .

T h e r e i s n o o p t i o n t o t u r n o d a t a b a s e c o m p l e t e l y . I f y o u d o n o t w a n t t o u s e i t j u s t

d o n o t d o t h e i n i t i a l b u i l d o f t h e d a t a b a s e a n d d o n o t l o a d i t t o R A M .





T a g T y p e O r i g i n

l e n a m e s t r i n g s y s t e m

a l b u m s t r i n g i d t a g

a l b u m a r t i s t s t r i n g i d t a g

a r t i s t s t r i n g i d t a g

c o m m e n t s t r i n g i d t a g

c o m p o s e r s t r i n g i d t a g

g e n r e s t r i n g i d t a g

g r o u p i n g s t r i n g i d t a g

t i t l e s t r i n g i d t a g

b i t r a t e n u m e r i c i d t a g

d i s c n u m n u m e r i c i d t a g

y e a r n u m e r i c i d t a g

t r a c k n u m n u m e r i c i d t a g / l e n a m e

a u t o s c o r e n u m e r i c r u n t i m e d b

l a s t p l a y e d n u m e r i c r u n t i m e d b

p l a y c o u n t n u m e r i c r u n t i m e d b

P m ( p l a y t i m e -

m i n )

n u m e r i c r u n t i m e d b

P s ( p l a y t i m e - s e c ) n u m e r i c r u n t i m e d b

r a t i n g n u m e r i c r u n t i m e d b

c o m m i t i d n u m e r i c s y s t e m

e n t r y a g e n u m e r i c s y s t e m

l e n g t h n u m e r i c s y s t e m

L m ( t r a c k l e n -

m i n )

n u m e r i c s y s t e m

L s ( t r a c k l e n - s e c ) n u m e r i c s y s t e m

4 . 3 . W h i l e P l a y i n g S c r e e n

T h e W h i l e P l a y i n g S c r e e n ( W P S ) d i s p l a y s v a r i o u s p i e c e s o f i n f o r m a t i o n a b o u t t h e c u r -

r e n t l y p l a y i n g a u d i o l e . T h e a p p e a r a n c e o f t h e W P S c a n b e c o n g u r e d u s i n g W P S

c o n g u r a t i o n l e s . T h e i t e m s s h o w n d e p e n d o n y o u r c o n g u r a t i o n a l l i t e m s c a n b e

t u r n e d o n o r o i n d e p e n d e n t l y . R e f e r t o s e c t i o n B ( p a g e 1 8 5 ) f o r d e t a i l s o n h o w t o c h a n g e

t h e d i s p l a y o f t h e W P S .

• S t a t u s b a r : T h e S t a t u s b a r s h o w s B a t t e r y l e v e l , c h a r g e r s t a t u s , v o l u m e , p l a y m o d e ,

r e p e a t m o d e , s h u e m o d e a n d c l o c k . I n c o n t r a s t t o a l l o t h e r i t e m s , t h e s t a t u s b a r

i s a l w a y s a t t h e t o p o f t h e s c r e e n .

• ( S c r o l l i n g ) p a t h a n d l e n a m e o f t h e c u r r e n t s o n g .

• T h e I D 3 t r a c k n a m e .





• T h e I D 3 a l b u m n a m e .

• T h e I D 3 a r t i s t n a m e .

• B i t r a t e . V B R l e s d i s p l a y a v e r a g e b i t r a t e a n d ( a v g )

• E l a p s e d a n d t o t a l t i m e .

• A s l i d e b a r p r o g r e s s m e t e r r e p r e s e n t i n g w h e r e i n t h e s o n g y o u a r e .

• P e a k m e t e r .

S e e s e c t i o n 1 1 . 2 ( p a g e 1 7 0 ) f o r d e t a i l s o f c u s t o m i s i n g y o u r W P S ( W h i l e P l a y i n g S c r e e n ) .

4 . 3 . 1 . W P S K e y C o n t r o l s


U p / D o w n V o l u m e U p /

V o l u m e D o w n

V o l u m e u p / d o w n .

L e f t R e w i n d G o t o b e g i n n i n g o f t r a c k , o r i f p r e s s e d

w h i l e i n t h e r s t s e c o n d s o f a t r a c k , g o t o

t h e p r e v i o u s t r a c k .

L o n g L e f t L o n g R e w i n d R e w i n d i n t r a c k .

R i g h t F o r w a r d G o t o t h e n e x t t r a c k .

L o n g R i g h t L o n g F o r w a r d F a s t f o r w a r d i n t r a c k .

A P l a y T o g g l e p l a y / p a u s e .

P o w e r L o n g P l a y S t o p p l a y b a c k .

S e l e c t R e t u r n t o t h e F i l e B r o w s e r /

D a t a b a s e .

L o n g S e l e c t L o n g M e n u E n t e r W P S C o n t e x t M e n u .

M e n u M e n u E n t e r M a i n M e n u .

L o n g M e n u S w i t c h t o t h e Q u i c k S c r e e n ( s e e s e c -

t i o n 5 . 1 1 ( p a g e 4 6 ) ) .

A + U p / D o w n S h o w P i t c h S c r e e n ( s e e s e c t i o n 4 . 3 . 3

( p a g e 3 4 ) ) .

A + D o w n S h o w c u r r e n t P l a y l i s t .

A + M e n u A c t i v a t e t h e H o t k e y f u n c t i o n ( s e e s e c -

t i o n 4 . 5 ( p a g e 4 0 ) ) .

A + R i g h t o r

S h o r t R i g h t +

L o n g R i g h t

S h o r t F o r w a r d

+ L o n g

F o r w a r d

S k i p t o t h e n e x t d i r e c t o r y .

A + L e f t o r

S h o r t L e f t +

L o n g L e f t

S h o r t R e w i n d +

L o n g R e w i n d

S k i p t o t h e p r e v i o u s d i r e c t o r y .





4 . 3 . 2 . P e a k M e t e r

T h e p e a k m e t e r c a n b e d i s p l a y e d o n t h e W h i l e P l a y i n g S c r e e n a n d c o n s i s t s o f s e v e r a l

i n d i c a t o r s .

T h e b a r : T h i s i s t h e w i d e h o r i z o n t a l b a r . I t r e p r e s e n t s t h e c u r r e n t v o l u m e v a l u e .

T h e p e a k i n d i c a t o r : T h i s i s a l i t t l e v e r t i c a l l i n e a t t h e r i g h t e n d o f t h e b a r . I t i n d i c a t e s

t h e p e a k v o l u m e v a l u e t h a t o c c u r r e d r e c e n t l y .

T h e c l i p i n d i c a t o r : T h i s i s a l i t t l e b l a c k b l o c k t h a t i s d i s p l a y e d a t t h e v e r y r i g h t o f t h e

s c a l e w h e n a n o v e r o w o c c u r s . I t u s u a l l y d o e s n o t s h o w u p d u r i n g n o r m a l p l a y b a c k

u n l e s s y o u p l a y a n a u d i o l e t h a t i s d i s t o r t e d h e a v i l y .

N o t e : N o t e t h a t t h e c l i p d e t e c t i o n i s n o t v e r y p r e c i s e . C l i p p i n g m i g h t o c c u r w i t h - bo u t b e i n g i n d i c a t e d .

T h e s c a l e : B e t w e e n t h e i n d i c a t o r s o f t h e r i g h t a n d l e f t c h a n n e l t h e r e a r e l i t t l e d o t s .

T h e s e d o t s r e p r e s e n t i m p o r t a n t v o l u m e v a l u e s . I n l i n e a r m o d e e a c h d o t i s a 1 0 %

m a r k . I n d B F S m o d e t h e d o t s r e p r e s e n t t h e f o l l o w i n g v a l u e s ( f r o m r i g h t t o l e f t ) :

0 d B , - 3 d B , - 6 d B , - 9 d B , - 1 2 d B , - 1 8 d B , - 2 4 d B , - 3 0 d B , - 4 0 d B , - 5 0 d B , - 6 0 d B .

4 . 3 . 3 . T h e W P S C o n t e x t M e n u

L i k e t h e c o n t e x t m e n u f o r t h e F i l e B r o w s e r , t h e W P S C o n t e x t M e n u a l l o w s y o u

q u i c k a c c e s s t o s o m e o f t e n u s e d f u n c t i o n s .

P l a y l i s t

T h e P l a y l i s t s u b m e n u a l l o w s y o u t o v i e w , s a v e , s e a r c h a n d r e s h u e t h e c u r r e n t p l a y l i s t .

T o c h a n g e s e t t i n g s f o r t h e P l a y l i s t V i e w e r p r e s s L o n g S e l e c t w h i l e v i e w i n g t h e

c u r r e n t p l a y l i s t t o b r i n g u p t h e P l a y l i s t V i e w e r M e n u . I n t h i s m e n u , y o u c a n n d

t h e P l a y l i s t V i e w e r S e t t i n g s .

P l a y l i s t V i e w e r S e t t i n g s

S h o w I c o n s . T h i s t o g g l e s d i s p l a y o f t h e i c o n f o r t h e c u r r e n t l y s e l e c t e d p l a y l i s t e n t r y a n d

t h e i c o n f o r m o v i n g a p l a y l i s t e n t r y

S h o w I n d i c i e s . T h i s t o g g l e s d i s p l a y o f t h e l i n e n u m b e r i n g f o r t h e p l a y l i s t

T r a c k D i s p l a y . T h i s t o g g l e s b e t w e e n l e n a m e o n l y a n d f u l l p a t h f o r p l a y l i s t e n t r i e s

S a v e C u r r e n t P l a y l i s t . A l l o w s t h e c u r r e n t p l a y l i s t t o b e s a v e d a s a . m 3 u 8 p l a y l i s t l e





P l a y l i s t c a t a l o g

V i e w c a t a l o g . T h i s l i s t s a l l p l a y l i s t s t h a t a r e p a r t o f t h e P l a y l i s t c a t a l o g . Y o u c a n l o a d

a n e w p l a y l i s t d i r e c t l y f r o m t h i s l i s t .

A d d t o p l a y l i s t . A d d s t h e c u r r e n t l y p l a y i n g l e t o a p l a y l i s t . S e l e c t t h e p l a y l i s t y o u w a n t

t h e l e t o b e a d d e d t o a n d i t w i l l g e t a p p e n d e d t o t h a t p l a y l i s t .

A d d t o n e w p l a y l i s t . S i m i l a r t o t h e p r e v i o u s e n t r y t h i s w i l l a d d t h e c u r r e n t l y p l a y i n g

t r a c k t o a p l a y l i s t . Y o u n e e d t o e n t e r a n a m e f o r t h e n e w p l a y l i s t r s t .

S o u n d S e t t i n g s

T h i s i s a s h o r t c u t t o t h e S o u n d S e t t i n g s M e n u , w h e r e y o u c a n c o n g u r e v o l u m e ,

b a s s , t r e b l e , a n d o t h e r s e t t i n g s a e c t i n g t h e s o u n d o f y o u r m u s i c . S e e s e c t i o n 6 ( p a g e 4 7 )

f o r m o r e i n f o r m a t i o n .

P l a y b a c k S e t t i n g s

T h i s i s a s h o r t c u t t o t h e P l a y b a c k S e t t i n g s M e n u , w h e r e y o u c a n c o n g u r e s h u e ,

r e p e a t , p a r t y m o d e , s k i p l e n g t h a n d o t h e r s e t t i n g s a e c t i n g t h e p l a y b a c k o f y o u r m u s i c .

R a t i n g

T h e m e n u e n t r y i s o n l y s h o w n i f G a t h e r R u n t i m e I n f o r m a t i o n i s e n a b l e d . I t a l l o w s

t h e a s i g n m e n t o f a p e r s o n a l r a t i n g v a l u e ( 0 1 0 ) t o a t r a c k w h i c h c a n b e d i s p l a y e d i n

t h e W P S a n d u s e d i n t h e D a t a b a s e b r o w s e r . T h e v a l u e w r a p s a t 1 0 .

B o o k m a r k s

T h i s a l l o w s y o u t o c r e a t e a b o o k m a r k i n t h e c u r r e n t l y - p l a y i n g t r a c k .





S h o w T r a c k I n f o

F i g u r e 4 . 4 . : T h e t r a c k i n f o v i e w e r

T h i s s c r e e n i s a c c e s s i b l e f r o m t h e W P S s c r e e n , a n d p r o v i d e s a d e t a i l e d v i e w o f a l l t h e

i d e n t i t y i n f o r m a t i o n a b o u t t h e c u r r e n t t r a c k . T h i s i n f o i s k n o w n a s m e t a d a t a a n d i s

s t o r e d i n a u d i o l e f o r m a t s t o k e e p i n f o r m a t i o n o n a r t i s t , a l b u m e t c . T o a c c e s s t h i s s c r e e n ,

p r e s s L o n g S e l e c t t o a c c e s s t h e W P S C o n t e x t M e n u a n d s e l e c t S h o w T r a c k I n f o .

O p e n W i t h . . .

T h i s O p e n W i t h f u n c t i o n i s t h e s a m e a s t h e O p e n W i t h f u n c t i o n i n t h e l e b r o w s e r ' s

C o n t e x t M e n u .

D e l e t e

D e l e t e t h e c u r r e n t l y p l a y i n g l e . T h e l e w i l l b e d e l e t e d b u t t h e p l a y b a c k o f t h e l e w i l l

n o t s t o p i m m e d i a t e l y . I n s t e a d , t h e p a r t o f t h e l e t h a t h a s a l r e a d y b e e n b u e r e d ( i . e .

r e a d i n t o t h e p l a y e r ' s m e m o r y ) w i l l b e p l a y e d . T h i s m a y e v e n b e t h e w h o l e t r a c k .

P i t c h

T h e P i t c h S c r e e n a l l o w s y o u t o c h a n g e t h e r a t e o f p l a y b a c k ( i . e . t h e p l a y b a c k s p e e d

a n d a t t h e s a m e t i m e t h e p i t c h ) o f y o u r p l a y e r . T h e r a t e v a l u e c a n b e a d j u s t e d b e t w e e n

5 0 % a n d 2 0 0 % . 5 0 % m e a n s h a l f t h e n o r m a l p l a y b a c k s p e e d a n d a p i t c h t h a t i s a n o c t a v e





l o w e r t h a n t h e n o r m a l p i t c h . 2 0 0 % m e a n s d o u b l e p l a y b a c k s p e e d a n d a p i t c h t h a t i s a n

o c t a v e h i g h e r t h a n t h e n o r m a l p i t c h .

T h e r a t e c a n b e c h a n g e d i n t w o m o d e s : p r o c e n t u a l a n d s e m i t o n e . I n i t i a l l y , p r o c e n t u a l

m o d e i s a c t i v e .

I f y o u ' v e e n a b l e d t h e T i m e s t r e t c h o p t i o n i n S o u n d S e t t i n g s a n d h a v e s i n c e r e -

b o o t e d , y o u c a n a l s o u s e t i m e s t r e t c h m o d e . T h i s a l l o w s y o u t o c h a n g e t h e p l a y b a c k s p e e d

w i t h o u t a e c t i n g t h e p i t c h , a n d v i c e v e r s a .

I n t i m e s t r e t c h m o d e t h e r e a r e s e p a r a t e d i s p l a y s f o r p i t c h a n d s p e e d , a n d e a c h c a n b e

a l t e r e d i n d e p e n d e n t l y . D u e t o t h e l i m i t a t i o n s o f t h e a l g o r i t h m , s p e e d i s l i m i t e d t o b e

b e t w e e n 3 5 % a n d 2 5 0 % o f t h e c u r r e n t p i t c h v a l u e . P i t c h m u s t m a i n t a i n t h e s a m e r a t i o

a s w e l l a s r e m a i n b e t w e e n 5 0 % a n d 2 0 0 % .

T h e v a l u e o f t h e r a t e , p i t c h a n d s p e e d i s n o t p e r s i s t e n t , i . e . a f t e r t h e p l a y e r i s t u r n e d

o n i t w i l l a l w a y s b e s e t t o 1 0 0 % . H o w e v e r , t h e r a t e , p i t c h a n d s p e e d i n f o r m a t i o n w i l l b e

s t o r e d i n a n y b o o k m a r k s y o u m a y c r e a t e ( s e e s e c t i o n 8 . 6 ( p a g e 6 8 ) ) a n d w i l l b e r e s t o r e d

u p o n p l a y i n g b a c k t h o s e b o o k m a r k s .


M e n u L o n g P l a y T o g g l e p i t c h c h a n g i n g m o d e ( c y c l e

t h r o u g h a l l a v a i l a b l e m o d e s ) .


V o l u m e D o w n

I n c r e a s e / D e c r e a s e p i t c h b y 0 . 1 % ( i n p r o -

c e n t u a l m o d e ) o r 0 . 1 s e m i t o n e ( i n s e m i -

t o n e m o d e ) .

L o n g U p / L o n g

D o w n

L o n g V o l u m e

U p / L o n g

V o l u m e D o w n

I n c r e a s e / D e c r e a s e p i t c h b y 1 % ( i n p r o -

c e n t u a l m o d e ) o r a s e m i t o n e ( i n s e m i t o n e

m o d e ) .

L e f t / R i g h t R e w i n d /

F o r w a r d

T e m p o r a r i l y c h a n g e p i t c h b y 2 % ( b e a t -

m a t c h ) , o r m o d i f y s p e e d ( i n t i m e s t r e t c h

m o d e ) .

A P l a y R e s e t p i t c h a n d s p e e d t o 1 0 0 % .

P o w e r M e n u L e a v e t h e P i t c h S c r e e n .

4 . 4 . W o r k i n g w i t h P l a y l i s t s

4 . 4 . 1 . P l a y l i s t t e r m i n o l o g y

S o m e c o m m o n t e r m s t h a t a r e u s e d i n R o c k b o x w h e n r e f e r r i n g t o p l a y l i s t s :

D i r e c t o r y . A p l a y l i s t ! O n e o f t h e k e y s t o g e t t i n g t h e m o s t o u t o f R o c k b o x i s u n d e r -

s t a n d i n g t h a t R o c k b o x a l w a y s c o n s i d e r s t h e s o n g t h a t i t i s p l a y i n g t o b e p a r t o f a

p l a y l i s t , a n d i n s o m e s i t u a t i o n s , R o c k b o x w i l l c r e a t e a p l a y l i s t a u t o m a t i c a l l y . F o r

e x a m p l e , i f y o u a r e p l a y i n g t h e c o n t e n t s o f a d i r e c t o r y , R o c k b o x w i l l a u t o m a t i c a l l y





c r e a t e a p l a y l i s t c o n t a i n i n g a l l s o n g s i n i t . T h i s m e a n s t h a t j u s t a b o u t a n y t h i n g

t h a t i s d e s c r i b e d i n t h i s c h a p t e r w i t h r e s p e c t t o p l a y l i s t s a l s o a p p l i e s t o d i r e c t o r i e s .

D y n a m i c p l a y l i s t . A d y n a m i c p l a y l i s t i s a p l a y l i s t t h a t i s c r e a t e d O n t h e y . A n y

t i m e y o u i n s e r t o r q u e u e t r a c k s u s i n g t h e P l a y l i s t s u b m e n u ( s e e s e c t i o n 4 . 4 . 3

( p a g e 3 7 ) ) , y o u a r e c r e a t i n g ( o r a d d i n g t o ) a d y n a m i c p l a y l i s t .

I n s e r t . I n R o c k b o x , t o I n s e r t a n i t e m i n t o a p l a y l i s t m e a n s p u t t i n g a n i t e m i n t o a

p l a y l i s t a n d l e a v i n g i t t h e r e , e v e n a f t e r i t i s p l a y e d . A s y o u w i l l s e e l a t e r i n t h i s

c h a p t e r , R o c k b o x c a n I n s e r t i n t o a p l a y l i s t i n s e v e r a l p l a c e s .

Q u e u e . I n R o c k b o x , t o Q u e u e a s o n g m e a n s t o p u t t h e s o n g i n t o a p l a y l i s t a n d t h e n

t o r e m o v e t h e s o n g f r o m t h e p l a y l i s t o n c e i t h a s b e e n p l a y e d . T h e o n l y d i e r e n c e

b e t w e e n I n s e r t a n d Q u e u e i s t h a t t h e Q u e u e o p t i o n r e m o v e s t h e s o n g f r o m t h e

p l a y l i s t o n c e i t h a s b e e n p l a y e d , a n d t h e I n s e r t o p t i o n d o e s n o t .

4 . 4 . 2 . C r e a t i n g p l a y l i s t s

R o c k b o x c a n c r e a t e p l a y l i s t s i n f o u r d i e r e n t w a y s .

B y s e l e c t i n g ( p l a y i n g ) a s o n g f r o m t h e F i l e B r o w s e r

W h e n e v e r a s o n g i s s e l e c t e d f r o m t h e F i l e B r o w s e r w i t h S e l e c t o r R i g h t , R o c k b o x

w i l l a u t o m a t i c a l l y c r e a t e a p l a y l i s t c o n t a i n i n g a l l o f t h e s o n g s i n t h a t d i r e c t o r y a n d s t a r t

p l a y b a c k w i t h t h e s e l e c t e d s o n g .

N o t e : I f y o u a l r e a d y h a v e c r e a t e d a d y n a m i c p l a y l i s t , p l a y i n g a n e w s o n g w i l l e r a s e t h e bc u r r e n t d y n a m i c p l a y l i s t a n d c r e a t e a n e w o n e . I f y o u w a n t t o a d d a s o n g t o t h e c u r r e n t

p l a y l i s t r a t h e r t h a n e r a s i n g t h e c u r r e n t p l a y l i s t , s e e t h e s e c t i o n b e l o w o n h o w t o a d d

m u s i c t o a p l a y l i s t .

B y u s i n g I n s e r t a n d Q u e u e f u n c t i o n s

I f p l a y b a c k i s s t o p p e d , t h e I n s e r t a n d Q u e u e f u n c t i o n s c a n b e u s e d a s d e s c r i b e d i n

4 . 4 . 3 t o c r e a t e a n e w p l a y l i s t i n s t e a d o f a d d i n g t o a n e x i s t i n g o n e . T h i s w i l l e r a s e a n y

d y n a m i c p l a y l i s t .

B y u s i n g t h e P l a y l i s t c a t a l o g

T h e P l a y l i s t c a t a l o g m a k e s i t p o s s i b l e t o m o d i f y a n d c r e a t e p l a y l i s t s t h a t a r e n o t

c u r r e n t l y p l a y i n g . T o d o t h i s s e l e c t P l a y l i s t c a t a l o g i n t h e C o n t e x t M e n u . T h e r e

y o u w i l l h a v e t w o c h o i c e s , A d d t o p l a y l i s t a d d s t h e s e l e c t e d t r a c k o r d i r e c t o r y t o a n

e x i s t i n g p l a y l i s t a n d A d d t o a n e w p l a y l i s t c r e a t e s a n e w p l a y l i s t c o n t a i n i n g t h e

s e l e c t e d t r a c k o r d i r e c t o r y .





N o t e : A l l p l a y l i s t s i n t h e P l a y l i s t c a t a l o g a r e s t o r e d b y d e f a u l t i n t h e / P l a y l i s t s bd i r e c t o r y i n t h e r o o t o f y o u r p l a y e r ' s d i s k a n d p l a y l i s t s s t o r e d i n o t h e r l o c a t i o n s a r e

n o t i n c l u d e d i n t h e c a t a l o g . I t i s h o w e v e r p o s s i b l e t o m o v e e x i s t i n g p l a y l i s t s t h e r e ( s e e

s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) .

B y u s i n g t h e M a i n M e n u

T o c r e a t e a p l a y l i s t c o n t a i n i n g a l l m u s i c o n y o u r p l a y e r , y o u c a n u s e t h e C r e a t e

P l a y l i s t c o m m a n d i n t h e P l a y l i s t s m e n u f o u n d i n t h e M a i n M e n u . T h e c r e a t e d

p l a y l i s t w i l l b e n a m e d r o o t . m 3 u 8 a n d s a v e d i n t h e r o o t o f y o u r p l a y e r ' s d i s k .

4 . 4 . 3 . A d d i n g m u s i c t o p l a y l i s t s

A d d i n g m u s i c t o a d y n a m i c p l a y l i s t

F i g u r e 4 . 5 . : T h e P l a y l i s t S u b m e n u

T h e P l a y l i s t S u b m e n u i s a s u b m e n u i n t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) ,

i t a l l o w s y o u t o p u t t r a c k s i n t o a d y n a m i c p l a y l i s t . I f t h e r e i s n o m u s i c c u r r e n t l y p l a y -

i n g , R o c k b o x w i l l c r e a t e a n e w d y n a m i c p l a y l i s t a n d p u t t h e s e l e c t e d t r a c k ( s ) i n t o i t .

I f t h e r e i s m u s i c c u r r e n t l y p l a y i n g , R o c k b o x w i l l p u t t h e s e l e c t e d t r a c k ( s ) i n t o t h e c u r -

r e n t p l a y l i s t . T h e p l a c e i n w h i c h t h e n e w l y s e l e c t e d t r a c k s a r e a d d e d t o t h e p l a y l i s t i s

d e t e r m i n e d b y t h e f o l l o w i n g o p t i o n s :

I n s e r t . A d d t r a c k ( s ) i m m e d i a t e l y a f t e r a n y t r a c k s a d d e d v i a t h e m o s t r e c e n t I n s e r t

o p e r a t i o n . I f n o t r a c k s h a v e y e t b e e n a d d e d v i a a n I n s e r t , n e w t r a c k s w i l l b e





a d d e d i m m e d i a t e l y a f t e r t h e c u r r e n t p l a y i n g t r a c k . I f p l a y b a c k i s s t o p p e d a n e w

d y n a m i c p l a y l i s t w i l l g e t c r e a t e d w i t h t h e s e l e c t e d t r a c k s .

I n s e r t N e x t . A d d t r a c k ( s ) i m m e d i a t e l y a f t e r c u r r e n t p l a y i n g t r a c k , n o m a t t e r w h a t e l s e

h a s b e e n i n s e r t e d .

I n s e r t L a s t . A d d t r a c k ( s ) t o e n d o f p l a y l i s t .

I n s e r t S h u e d . A d d t r a c k ( s ) t o t h e p l a y l i s t i n a r a n d o m o r d e r .

I n s e r t L a s t S h u e d . A d d t r a c k s i n a r a n d o m o r d e r t o t h e e n d o f t h e p l a y l i s t .

Q u e u e . Q u e u e i s t h e s a m e a s I n s e r t e x c e p t q u e u e d t r a c k s a r e d e l e t e d i m m e d i a t e l y f r o m

t h e p l a y l i s t a f t e r t h e y h a v e b e e n p l a y e d . A l s o , q u e u e d t r a c k s a r e n o t s a v e d t o t h e

p l a y l i s t l e ( s e e s e c t i o n 5 . 8 ( p a g e 4 4 ) ) .

Q u e u e N e x t . Q u e u e t r a c k ( s ) i m m e d i a t e l y a f t e r c u r r e n t p l a y i n g t r a c k .

Q u e u e L a s t . Q u e u e t r a c k ( s ) a t e n d o f p l a y l i s t .

Q u e u e S h u e d . Q u e u e t r a c k ( s ) i n a r a n d o m o r d e r .

Q u e u e L a s t S h u e d . Q u e u e t r a c k s i n a r a n d o m o r d e r a t t h e e n d o f t h e p l a y l i s t .

P l a y N e x t . R e p l a c e s a l l b u t t h e c u r r e n t p l a y i n g t r a c k w i t h t r a c k ( s ) . C u r r e n t p l a y i n g

t r a c k i s q u e u e d .

T h e P l a y l i s t S u b m e n u c a n b e u s e d t o a d d e i t h e r s i n g l e t r a c k s o r e n t i r e d i r e c t o r i e s

t o a p l a y l i s t . I f t h e P l a y l i s t S u b m e n u i s i n v o k e d o n a s i n g l e t r a c k , i t w i l l p u t o n l y

t h a t t r a c k i n t o t h e p l a y l i s t . O n t h e o t h e r h a n d , i f t h e P l a y l i s t S u b m e n u i s i n v o k e d o n

a d i r e c t o r y , R o c k b o x a d d s a l l o f t h e t r a c k s i n t h a t d i r e c t o r y t o t h e p l a y l i s t .

N o t e : Y o u c a n c o n t r o l w h e t h e r o r n o t R o c k b o x i n c l u d e s t h e c o n t e n t s o f s u b d i r e c t o r i e s bw h e n a d d i n g a n e n t i r e d i r e c t o r y t o a p l a y l i s t s . S e t t h e S e t t i n g s → G e n e r a l S e t t i n g s

→ P l a y l i s t → R e c u r s i v e l y I n s e r t D i r e c t o r i e s s e t t i n g t o Y e s i f y o u w o u l d l i k e

R o c k b o x t o i n c l u d e t r a c k s i n s u b d i r e c t o r i e s a s w e l l a s t r a c k s i n t h e c u r r e n t l y - s e l e c t e d

d i r e c t o r y .

D y n a m i c p l a y l i s t s a r e s a v e d s o r e s u m e w i l l r e s t o r e t h e m e x a c t l y a s t h e y w e r e b e f o r e

s h u t d o w n .

N o t e : T o v i e w , s a v e o r r e s h u e t h e c u r r e n t d y n a m i c p l a y l i s t u s e t h e P l a y l i s t s u b m e n u bi n t h e W P S c o n t e x t m e n u o r i n t h e M a i n M e n u .





4 . 4 . 4 . M o d i f y i n g p l a y l i s t s

R e s h u i n g

R e s h u i n g t h e c u r r e n t p l a y l i s t i s e a s i l y d o n e f r o m t h e P l a y l i s t s u b m e n u i n t h e W P S ,

j u s t s e l e c t R e s h u f f l e .

M o v i n g a n d r e m o v i n g t r a c k s

T o m o v e o r r e m o v e a t r a c k f r o m t h e c u r r e n t p l a y l i s t e n t e r t h e P l a y l i s t V i e w e r b y

s e l e c t i n g V i e w C u r r e n t P l a y l i s t i n t h e P l a y l i s t s u b m e n u i n t h e W P S c o n t e x t

m e n u o r t h e M a i n M e n u . O n c e i n t h e P l a y l i s t V i e w e r o p e n t h e c o n t e x t m e n u o n

t h e t r a c k y o u w a n t t o m o v e o r r e m o v e . I f y o u w a n t t o m o v e t h e t r a c k , s e l e c t M o v e i n

t h e c o n t e x t m e n u a n d t h e n m o v e t h e b l i n k i n g c u r s o r t o t h e p l a c e w h e r e y o u w a n t t h e

t r a c k t o b e m o v e d a n d c o n r m w i t h S e l e c t o r R i g h t . T o r e m o v e a t r a c k , s i m p l y s e l e c t

R e m o v e i n t h e c o n t e x t m e n u .

4 . 4 . 5 . S a v i n g p l a y l i s t s

T o s a v e t h e c u r r e n t p l a y l i s t e i t h e r e n t e r t h e P l a y l i s t s u b m e n u i n t h e W P S C o n t e x t

M e n u ( s e e s e c t i o n 4 . 3 . 3 ( p a g e 3 2 ) ) a n d s e l e c t S a v e C u r r e n t P l a y l i s t o r e n t e r t h e

P l a y l i s t O p t i o n s m e n u i n t h e M a i n M e n u a n d s e l e c t S a v e C u r r e n t P l a y l i s t .

E i t h e r m e t h o d w i l l b r i n g y o u t o t h e V i r t u a l K e y b o a r d ( s e e s e c t i o n 4 . 1 . 3 ( p a g e 2 6 ) ) ,

e n t e r a l e n a m e f o r y o u r p l a y l i s t a n d a c c e p t i t a n d y o u a r e d o n e .

4 . 4 . 6 . L o a d i n g s a v e d p l a y l i s t s

T h r o u g h t h e F i l e B r o w s e r

P l a y l i s t l e s , l i k e r e g u l a r m u s i c t r a c k s , c a n b e s e l e c t e d t h r o u g h t h e F i l e B r o w s e r .

W h e n l o a d i n g a p l a y l i s t f r o m d i s k i t w i l l r e p l a c e t h e c u r r e n t d y n a m i c p l a y l i s t .

T h r o u g h t h e P l a y l i s t c a t a l o g

T h e P l a y l i s t c a t a l o g o e r s a s h o r t c u t t o a l l p l a y l i s t s i n y o u r p l a y e r ' s s p e c i e d p l a y l i s t

d i r e c t o r y . I t c a n b e u s e d l i k e t h e F i l e B r o w s e r .

4 . 4 . 7 . H e l p f u l H i n t s

I n c l u d i n g s u b d i r e c t o r i e s i n p l a y l i s t s

Y o u c a n c o n t r o l w h e t h e r o r n o t R o c k b o x i n c l u d e s t h e c o n t e n t s o f s u b d i r e c t o r i e s w h e n

a d d i n g a n e n t i r e d i r e c t o r y t o a p l a y l i s t s . S e t t h e M a i n M e n u → S e t t i n g s → G e n e r a l

S e t t i n g s → P l a y l i s t s → R e c u r s i v e l y I n s e r t D i r e c t o r i e s s e t t i n g t o O n i f y o u

w o u l d l i k e t o i n c l u d e t r a c k s i n s u b d i r e c t o r i e s a s w e l l a s t r a c k s i n t h e c u r r e n t l y s e l e c t e d

d i r e c t o r y .





4 . 5 . H o t k e y s

H o t k e y s a r e s h o r t c u t k e y s f o r u s e i n t h e F i l e B r o w s e r a n d W P S s c r e e n . T o u s e o n e ,

p r e s s A + M e n u w i t h i n t h e F i l e B r o w s e r o r A + M e n u w i t h i n t h e W P S s c r e e n . T h e

a s s i g n e d f u n c t i o n w i l l l a u n c h w i t h r e f e r e n c e t o t h e c u r r e n t l e o r d i r e c t o r y , i f a p p l i c a b l e .

E a c h s c r e e n h a s i t s o w n a s s i g n m e n t . I f t h e r e i s n o a s s i g n m e n t f o r a g i v e n s c r e e n , t h e

h o t k e y i s i g n o r e d .

T h e d e f a u l t a s s i g n m e n t f o r t h e F i l e B r o w s e r h o t k e y i s O f f , w h i l e t h e d e f a u l t f o r t h e

W P S h o t k e y i s V i e w P l a y l i s t .

T h e h o t k e y a s s i g n m e n t s a r e c h a n g e d i n t h e H o t k e y m e n u ( s e e s e c t i o n 8 . 9 ( p a g e 7 1 ) )

u n d e r G e n e r a l S e t t i n g s .




C h a p t e r 5 . T h e M a i n M e n u 4 1

5 . T h e M a i n M e n u

5 . 1 . I n t r o d u c i n g t h e M a i n M e n u

F i g u r e 5 . 1 . : T h e m a i n m e n u

T h e M a i n M e n u i s t h e s c r e e n f r o m w h i c h a l l o f t h e R o c k b o x f u n c t i o n s c a n b e a c c e s s e d .

T h i s i s t h e r s t s c r e e n y o u w i l l s e e w h e n s t a r t i n g R o c k b o x . T o r e t u r n t o t h e M a i n

M e n u , p r e s s t h e M e n u b u t t o n .

A l l s e t t i n g s a r e s t o r e d o n t h e u n i t . H o w e v e r , R o c k b o x d o e s n o t a c c e s s t h e h a r d d i s k

s o l e l y f o r t h e p u r p o s e o f s a v i n g s e t t i n g s . I n s t e a d , R o c k b o x w i l l s a v e s e t t i n g s w h e n i t

a c c e s s e s t h e h a r d d i s k t h e n e x t t i m e , f o r e x a m p l e w h e n r e l l i n g t h e m u s i c b u e r o r

n a v i g a t i n g t h r o u g h t h e F i l e B r o w s e r . C h a n g e s t o s e t t i n g s m a y t h e r e f o r e n o t b e s a v e d

u n l e s s t h e p l a y e r i s s h u t d o w n s a f e l y ( s e e s e c t i o n 3 . 1 . 2 ( p a g e 1 9 ) ) .





5 . 2 . N a v i g a t i n g t h e M a i n M e n u


D o w n V o l u m e D o w n S e l e c t t h e n e x t o p t i o n i n t h e m e n u .

I n s i d e a s e t t i n g , i n c r e a s e t h e v a l u e o r

c h o o s e n e x t o p t i o n .

U p V o l u m e U p S e l e c t t h e p r e v i o u s o p t i o n i n t h e m e n u .

I n s i d e a s e t t i n g , d e c r e a s e t h e v a l u e o r

c h o o s e p r e v i o u s o p t i o n .

S e l e c t o r R i g h t F o r w a r d S e l e c t o p t i o n .

L e f t o r P o w e r R e w i n d E x i t m e n u o r s e t t i n g , o r m o v e t o p a r e n t

m e n u .

5 . 3 . R e c e n t B o o k m a r k s

F i g u r e 5 . 2 . : T h e l i s t b o o k m a r k s s c r e e n

I f t h e S a v e a l i s t o f r e c e n t l y c r e a t e d b o o k m a r k s o p t i o n i s e n a b l e d t h e n y o u c a n

v i e w a l i s t o f s e v e r a l r e c e n t b o o k m a r k s h e r e a n d s e l e c t o n e t o j u m p s t r a i g h t t o t h a t t r a c k .

N o t e : B o o k m a r k i n g o n l y w o r k s w h e n t r a c k s a r e l a u n c h e d f r o m t h e l e b r o w s e r , a n d b





d o e s n o t c u r r e n t l y w o r k f o r t r a c k s l a u n c h e d v i a t h e d a t a b a s e . I n a d d i t i o n , t h e y d o n o t

c u r r e n t l y w o r k w i t h d y n a m i c p l a y l i s t s .


D o w n V o l u m e D o w n S e l e c t t h e n e x t b o o k m a r k .

U p V o l u m e U p S e l e c t t h e p r e v i o u s b o o k m a r k .

S e l e c t o r R i g h t F o r w a r d R e s u m e f r o m t h e s e l e c t e d b o o k m a r k .

L e f t o r P o w e r R e w i n d E x i t R e c e n t B o o k m a r k m e n u .

A L o n g M e n u D e l e t e t h e c u r r e n t l y s e l e c t e d b o o k m a r k .

L o n g S e l e c t L o n g M e n u E n t e r t h e c o n t e x t m e n u f o r t h e s e l e c t e d

b o o k m a r k .

T h e r e a r e t w o o p t i o n s i n t h e c o n t e x t m e n u :

R e s u m e w i l l c o m m e n c e p l a y b a c k o f t h e c u r r e n t l y s e l e c t e d b o o k m a r k e n t r y .

D e l e t e w i l l r e m o v e t h e c u r r e n t l y s e l e c t e d b o o k m a r k e n t r y f r o m t h e l i s t .

T h i s e n t r y i s n o t s h o w n i n t h e M a i n M e n u w h e n t h e o p t i o n i s o ( t h e d e f a u l t s e t t i n g ) .

S e e s e c t i o n 8 . 6 ( p a g e 6 8 ) f o r m o r e d e t a i l s o n c o n g u r i n g b o o k m a r k i n g i n R o c k b o x .

5 . 4 . F i l e s

B r o w s e t h e l e s o n y o u r p l a y e r ( s e e s e c t i o n 4 . 1 ( p a g e 2 2 ) ) .

5 . 5 . D a t a b a s e

B r o w s e b y t h e m e t a - d a t a i n y o u r a u d i o l e s ( s e e s e c t i o n 4 . 2 ( p a g e 2 7 ) ) .

5 . 6 . N o w P l a y i n g / R e s u m e P l a y b a c k

G o t o t h e W h i l e P l a y i n g S c r e e n a n d r e s u m e i f m u s i c p l a y b a c k i s s t o p p e d o r p a u s e d

a n d t h e r e i s s o m e t h i n g t o r e s u m e ( s e e s e c t i o n 4 . 3 ( p a g e 3 0 ) ) .

5 . 7 . S e t t i n g s

T h e S e t t i n g s m e n u a l l o w s y o u t o s e t o r a d j u s t m a n y p a r a m e t e r s t h a t a e c t t h e w a y

y o u r p l a y e r w o r k s . T h e r e a r e m a n y s u b m e n u s f o r d i e r e n t p a r a m e t e r a r e a s . E v e r y t i m e

y o u a r e s e t t i n g a v a l u e o f a p a r a m e t e r , a n d t h a t v a l u e i s s e l e c t e d f r o m a l i s t o f s o m e

p r e d e n e d a v a i l a b l e v a l u e s , y o u c a n p r e s s L o n g S e l e c t , a n d t h e s e l e c t i o n c u r s o r w i l l





j u m p t o t h e d e f a u l t v a l u e f o r t h e p a r a m e t e r . Y o u c a n t h e n c o n r m o r c a n c e l t h e v a l u e .

T h i s i s u s e f u l i f y o u h a v e c h a n g e d t h e v a l u e o f t h e p a r a m e t e r f r o m t h e d e f a u l t t o s o m e

o t h e r v a l u e a n d w o u l d l i k e t o r e s t o r e t h e d e f a u l t v a l u e .

5 . 7 . 1 . S o u n d S e t t i n g s

T h e S o u n d S e t t i n g s m e n u o e r s a s e l e c t i o n o f s o u n d p r o p e r t i e s y o u m a y c h a n g e t o

c u s t o m i s e y o u r l i s t e n i n g e x p e r i e n c e . T h e d e t a i l s o f t h i s m e n u a r e c o v e r e d i n s e c t i o n 6

( p a g e 4 7 ) .

5 . 7 . 2 . P l a y b a c k S e t t i n g s

T h e P l a y b a c k S e t t i n g s m e n u a l l o w s y o u t o c o n g u r e s e t t i n g s r e l a t e d t o a u d i o p l a y -

b a c k . T h e d e t a i l s o f t h i s m e n u a r e c o v e r e d i n s e c t i o n 7 ( p a g e 5 4 ) .

5 . 7 . 3 . G e n e r a l S e t t i n g s

T h e G e n e r a l S e t t i n g s m e n u a l l o w s y o u t o c u s t o m i s e t h e w a y R o c k b o x l o o k s a n d t h e

w a y i t p l a y s m u s i c . T h e d e t a i l s o f t h i s m e n u a r e c o v e r e d i n s e c t i o n 8 ( p a g e 6 1 ) .

5 . 7 . 4 . T h e m e S e t t i n g s

T h e T h e m e S e t t i n g s m e n u c o n t a i n s o p t i o n s t h a t c o n t r o l t h e v i s u a l a p p e r a n c e o f R o c k -

b o x . T h e d e t a i l s o f t h i s m e n u a r e c o v e r e d i n s e c t i o n 9 ( p a g e 7 2 ) .

5 . 7 . 5 . M a n a g e S e t t i n g s

T h e M a n a g e S e t t i n g s o p t i o n a l l o w s t h e s a v i n g a n d r e - l o a d i n g o f u s e r c o n g u r a t i o n

s e t t i n g s , b r o w s i n g t h e h a r d d r i v e f o r a l t e r n a t e r m w a r e s , a n d n a l l y r e s e t t i n g y o u r

p l a y e r b a c k t o i n i t i a l c o n g u r a t i o n . T h e d e t a i l s o f t h i s m e n u a r e c o v e r e d i n s e c t i o n 1 1 . 3

( p a g e 1 7 5 ) .

5 . 8 . P l a y l i s t s

T h i s m e n u a l l o w s y o u t o w o r k w i t h p l a y l i s t s . P l a y l i s t s c a n b e c r e a t e d i n t h r e e w a y s .

P l a y i n g a l e i n a d i r e c t o r y c a u s e s a l l t h e l e s i n i t t o b e p l a c e d i n a p l a y l i s t . P l a y l i s t s

c a n b e c r e a t e d m a n u a l l y b y e i t h e r u s i n g t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) )

o r u s i n g t h e P l a y l i s t m e n u . B o t h a u t o m a t i c a l l y a n d m a n u a l l y c r e a t e d p l a y l i s t s c a n b e

e d i t e d u s i n g t h i s m e n u .

C r e a t e P l a y l i s t : R o c k b o x w i l l c r e a t e a p l a y l i s t w i t h a l l t r a c k s i n t h e c u r r e n t d i r e c t o r y

a n d a l l s u b - d i r e c t o r i e s . T h e p l a y l i s t w i l l b e c r e a t e d o n e d i r e c t o r y l e v e l u p f r o m

w h e r e y o u c u r r e n t l y a r e .

V i e w C u r r e n t P l a y l i s t : D i s p l a y s t h e c o n t e n t s o f t h e p l a y l i s t c u r r e n t l y s t o r e d i n m e m o r y .





S a v e C u r r e n t P l a y l i s t : S a v e s t h e c u r r e n t d y n a m i c p l a y l i s t , e x c l u d i n g q u e u e d t r a c k s , t o

t h e s p e c i e d l e . I f n o p a t h i s p r o v i d e d t h e n p l a y l i s t i s s a v e d t o t h e c u r r e n t d i r e c -

t o r y .

V i e w C a t a l o g : P r o v i d e s a s i m p l e i n t e r f a c e t o m a i n t a i n s e v e r a l p l a y l i s t s ( s e e s e c t i o n 4 . 4

( p a g e 3 5 ) ) .

5 . 9 . P l u g i n s

W i t h t h i s o p t i o n y o u c a n l o a d a n d r u n v a r i o u s p l u g i n s t h a t h a v e b e e n w r i t t e n f o r R o c k -

b o x . T h e r e a r e a w i d e v a r i e t y o f t h e s e s u p p l i e d w i t h R o c k b o x , i n c l u d i n g s e v e r a l g a m e s ,

s o m e i m p r e s s i v e d e m o s a n d a n u m b e r o f u t i l i t i e s . A d e t a i l e d d e s c r i p t i o n o f t h e d i e r e n t

p l u g i n s i s t o b e f o u n d i n s e c t i o n 1 0 ( p a g e 7 4 ) .

5 . 1 0 . S y s t e m

T i m e a n d D a t e : T i m e r e l a t e d m e n u o p t i o n s . P r e s s i n g L o n g S e l e c t w i l l v o i c e t h e c u r r e n t

t i m e i f v o i c e s u p p o r t i s e n a b l e d

S e t T i m e / D a t e : S e t c u r r e n t t i m e a n d d a t e .

S l e e p T i m e r : T h e S l e e p T i m e r p o w e r s o y o u r p l a y e r a f t e r p l a y i n g f o r a g i v e n

t i m e . I t c a n b e s e t f r o m O f f t o 5 h o u r s i n 5 m i n u t e s t e p s . T h e S l e e p T i m e r

i s r e s e t o n b o o t .

T i m e F o r m a t : C h o o s e 1 2 o r 2 4 h o u r c l o c k .

R o c k b o x I n f o : D i s p l a y s s o m e b a s i c s y s t e m i n f o r m a t i o n . T h i s i s , f r o m t o p t o b o t t o m ,

t h e a m o u n t o f m e m o r y R o c k b o x h a s a v a i l a b l e f o r s t o r i n g m u s i c ( t h e b u e r ) . T h e

b a t t e r y s t a t u s . H a r d d i s k s i z e a n d t h e a m o u n t o f f r e e s p a c e o n t h e d i s k .

C r e d i t s : D i s p l a y t h e l i s t o f c o n t r i b u t o r s .

R u n n i n g T i m e : S h o w s t h e r u n t i m e o f y o u r p l a y e r i n h o u r s , m i n u t e s a n d s e c o n d s .

R u n n i n g T i m e : T h i s i t e m s h o w s t h e c u m u l a t i v e o v e r a l l r u n t i m e o f y o u r p l a y e r

s i n c e y o u e i t h e r d i s c o n n e c t e d i t f r o m c h a r g i n g ( i n R o c k b o x ) o r m a n u a l l y r e s e t

t h i s i t e m . A m a n u a l r e s e t i s d o n e t h r o u g h p r e s s i n g a n y b u t t o n , f o l l o w e d b y

p r e s s i n g S e l e c t o r R i g h t .

T o p T i m e : T h i s i t e m s h o w s t h e c u m u l a t i v e o v e r a l l r u n t i m e o f y o u r p l a y e r s i n c e

y o u l a s t m a n u a l l y r e s e t t h i s i t e m . A m a n u a l r e s e t i s d o n e t h r o u g h p r e s s i n g

a n y b u t t o n , f o l l o w e d b y p r e s s i n g S e l e c t o r R i g h t .

D e b u g ( K e e p O u t ! ) : T h i s s u b m e n u i s i n t e n d e d t o b e u s e d o n l y b y R o c k b o x d e v e l o p e r s .

I t s h o w s h a r d w a r e , d i s k , b a t t e r y s t a t u s a n d o t h e r t e c h n i c a l i n f o r m a t i o n .

W a r n i n g : I t i s n o t r e c o m m e n d e d t h a t u s e r s a c c e s s t h i s m e n u u n l e s s i n s t r u c t e d t o !d o s o i n t h e c o u r s e o f x i n g a p r o b l e m w i t h R o c k b o x . I f y o u t h i n k y o u h a v e m e s s e d





u p y o u r s e t t i n g s b y u s e o f t h i s m e n u p l e a s e t r y t o r e s e t a l l s e t t i n g s b e f o r e a s k i n g

f o r h e l p .

5 . 1 1 . Q u i c k S c r e e n

A l t h o u g h t h e Q u i c k S c r e e n i s a c c e s s i b l e f r o m n e a r l y e v e r y w h e r e , n o t j u s t t h e M a i n

M e n u , i t i s w o r t h m e n t i o n i n g h e r e . I t a l l o w s r a p i d a c c e s s t o y o u r f o u r f a v o u r i t e s e t t i n g s .

T h e d e f a u l t s e t t i n g s a r e S h u f f l e ( s e c t i o n 7 ( p a g e 5 4 ) ) , R e p e a t ( s e c t i o n 7 ( p a g e 5 4 ) )

a n d t h e S h o w F i l e s ( s e c t i o n 8 . 2 ( p a g e 6 2 ) ) o p t i o n s , b u t a l m o s t a l l c o n g u r a b l e o p t i o n s

i n R o c k b o x c a n b e p l a c e d o n t h i s s c r e e n . T o c h a n g e t h e o p t i o n s , n a v i g a t e t h r o u g h t h e

m e n u s t o t h e s e t t i n g y o u w a n t t o a d d a n d p r e s s L o n g S e l e c t . I n t h e m e n u w h i c h a p p e a r s

y o u w i l l b e g i v e n o p t i o n s t o p l a c e t h e s e t t i n g o n t h e Q u i c k S c r e e n .

P r e s s L o n g M e n u t o a c c e s s i t a n d M e n u t o e x i t . T h e d i r e c t i o n b u t t o n s w i l l m o d i f y

t h e i n d i v i d u a l s e t t i n g v a l u e s a s i n d i c a t e d b y t h e a r r o w i c o n s . P l e a s e n o t e t h a t t h e s e t t i n g s

a t o p p o s i t e s i d e s o f t h e s c r e e n c y c l e t h r o u g h t h e a v a i l a b l e o p t i o n s i n o p p o s i t e d i r e c t i o n s .

T h e r e f o r e i f y o u s e l e c t t h e s a m e s e t t i n g a t e . g . t h e t o p a n d b o t t o m o f t h e q u i c k s c r e e n ,

t h e n p r e s s i n g u p a n d d o w n w i l l c y c l e t h r o u g h t h i s s e t t i n g i n o p p o s i t e d i r e c t i o n s .




C h a p t e r 6 . S o u n d S e t t i n g s 4 7

6 . S o u n d S e t t i n g s

F i g u r e 6 . 1 . : T h e s o u n d s e t t i n g s s c r e e n

T h e s o u n d s e t t i n g s m e n u o e r s a s e l e c t i o n o f s o u n d s e t t i n g s y o u m a y c h a n g e t o c u s t o m i s e

y o u r l i s t e n i n g e x p e r i e n c e .

6 . 1 . V o l u m e

T h i s s e t t i n g a d j u s t s t h e v o l u m e o f y o u r m u s i c . L i k e m o s t p r o f e s s i o n a l a u d i o g e a r a n d

m a n y c o n s u m e r a u d i o p r o d u c t s , R o c k b o x u s e s a d e c i b e l s c a l e w h e r e 0 d B i s a r e f e r -

e n c e t h a t i n d i c a t e s t h e m a x i m u m v o l u m e t h a t t h e p l a y e r c a n p r o d u c e w i t h o u t p o s s i b l e

d i s t o r t i o n ( c l i p p i n g ) . A l l v a l u e s l o w e r t h a n t h i s r e f e r e n c e w i l l b e n e g a t i v e a n d y i e l d a

p r o g r e s s i v e l y s o f t e r v o l u m e . V a l u e s h i g h e r t h a n 0 d B a r e a v a i l a b l e a n d c a n b e u s e d t o

r a i s e t h e v o l u m e m o r e t h a n w o u l d o t h e r w i s e b e p o s s i b l e . T h e s e v o l u m e l e v e l s w i l l o r d i -

n a r i l y l e a d t o d i s t o r t e d s o u n d , b u t m i g h t w o r k n i c e l y f o r m u s i c t h a t h a s a n o t h e r w i s e l o w

v o l u m e l e v e l . T h e v o l u m e c a n b e a d j u s t e d f r o m a m i n i m u m o f - 7 3 d B t o a m a x i m u m

o f + 6 d B . m i n i m u m o f - 7 4 d B t o a m a x i m u m o f + 6 d B .





6 . 2 . B a s s

T h i s s e t t i n g e m p h a s i s e s o r s u p p r e s s e s t h e l o w e r ( b a s s ) f r e q u e n c i e s i n t h e s o u n d . A v a l u e

o f 0 d B m e a n s t h a t b a s s s o u n d s a r e u n a l t e r e d ( a t r e s p o n s e ) .

6 . 3 . T r e b l e

T h i s s e t t i n g e m p h a s i s e s o r s u p p r e s s e s t h e h i g h e r ( t r e b l e ) f r e q u e n c i e s i n t h e s o u n d . A

v a l u e o f 0 d B m e a n s t h a t t r e b l e s o u n d s a r e u n a l t e r e d ( a t r e s p o n s e ) .

6 . 4 . B a l a n c e

T h i s s e t t i n g c o n t r o l s t h e b a l a n c e b e t w e e n t h e l e f t a n d r i g h t c h a n n e l s . T h e d e f a u l t , 0 ,

m e a n s t h a t t h e l e f t a n d r i g h t o u t p u t s a r e e q u a l i n v o l u m e . N e g a t i v e n u m b e r s i n c r e a s e

t h e v o l u m e o f t h e l e f t c h a n n e l r e l a t i v e t o t h e r i g h t , p o s i t i v e n u m b e r s i n c r e a s e t h e v o l u m e

o f t h e r i g h t c h a n n e l r e l a t i v e t o t h e l e f t .

6 . 5 . C h a n n e l s

A s t e r e o a u d i o s i g n a l c o n s i s t s o f t w o c h a n n e l s , l e f t a n d r i g h t . T h e C h a n n e l s s e t t i n g

d e t e r m i n e s i f t h e s e c h a n n e l s a r e t o b e c o m b i n e d i n a n y w a y , a n d i f s o , i n w h a t m a n n e r

t h e y w i l l b e c o m b i n e d . A v a i l a b l e o p t i o n s a r e :

S t e r e o . L e a v e t h e a u d i o s i g n a l u n m o d i e d .

M o n o . C o m b i n e b o t h c h a n n e l s a n d s e n d t h e r e s u l t i n g s i g n a l t o b o t h s t e r e o c h a n n e l s ,

r e s u l t i n g i n a m o n o p h o n i c o u t p u t .

C u s t o m . A l l o w s y o u t o m a n u a l l y s p e c i f y a s t e r e o w i d t h w i t h t h e S t e r e o W i d t h s e t t i n g

d e s c r i b e d l a t e r i n t h i s c h a p t e r .

M o n o L e f t . P l a y s t h e l e f t c h a n n e l i n b o t h s t e r e o c h a n n e l s .

M o n o R i g h t . P l a y s t h e r i g h t c h a n n e l i n b o t h s t e r e o c h a n n e l s .

K a r a o k e . R e m o v e s a l l s o u n d t h a t i s c o m m o n t o b o t h c h a n n e l s . S i n c e m o s t m u s i c i s

r e c o r d e d w i t h v o c a l s b e i n g e q u a l l y p r e s e n t i n b o t h c h a n n e l s t o m a k e t h e s i n g e r

s o u n d c e n t r a l l y p l a c e d , t h i s o f t e n ( b u t n o t a l w a y s ) h a s t h e e e c t o f r e m o v i n g t h e

v o i c e t r a c k f r o m a s o n g . T h i s s e t t i n g a l s o v e r y o f t e n h a s o t h e r u n d e s i r a b l e e e c t s

o n t h e s o u n d .

6 . 6 . S t e r e o W i d t h

S t e r e o w i d t h a l l o w s y o u t o m a n u a l l y s p e c i f y t h e e e c t t h a t i s a p p l i e d w h e n t h e C h a n n e l s

s e t t i n g i s s e t t o c u s t o m . A l l v a l u e s b e l o w 1 0 0 % w i l l p r o g r e s s i v e l y m i x t h e c o n t e n t s o f





o n e c h a n n e l i n t o t h e o t h e r . T h i s h a s t h e e e c t o f g r a d u a l l y c e n t e r i n g t h e s t e r e o i m a g e ,

u n t i l y o u h a v e m o n o p h o n i c s o u n d a t 0 % . V a l u e s a b o v e 1 0 0 % w i l l p r o g r e s s i v e l y r e m o v e

c o m p o n e n t s i n o n e c h a n n e l t h a t i s a l s o p r e s e n t i n t h e o t h e r . T h i s h a s t h e e e c t o f

w i d e n i n g t h e s t e r e o e l d . A v a l u e o f 1 0 0 % w i l l l e a v e t h e s t e r e o e l d u n a l t e r e d .

6 . 7 . C r o s s f e e d

C r o s s f e e d a t t e m p t s t o m a k e t h e e x p e r i e n c e o f l i s t e n i n g t o m u s i c o n h e a d p h o n e s m o r e

s i m i l a r t o l i s t e n i n g t o m u s i c w i t h s t e r e o s p e a k e r s . W h e n y o u l i s t e n t o m u s i c t h r o u g h

s p e a k e r s , e a c h e a r w i l l h e a r s o u n d o r i g i n a t i n g f r o m b o t h s p e a k e r s . H o w e v e r , t h e s o u n d

f r o m t h e l e f t s p e a k e r r e a c h e s y o u r r i g h t e a r s l i g h t l y l a t e r t h a n i t d o e s y o u r l e f t e a r , a n d

v i c e v e r s a .

T h e h u m a n e a r a n d b r a i n t o g e t h e r a r e v e r y g o o d a t i n t e r p r e t i n g t h e t i m e d i e r e n c e s

b e t w e e n d i r e c t s o u n d s a n d r e e c t e d s o u n d s a n d u s i n g t h a t i n f o r m a t i o n t o i d e n t i f y t h e

d i r e c t i o n t h a t t h e s o u n d i s c o m i n g f r o m . O n t h e o t h e r h a n d , w h e n l i s t e n i n g t o h e a d -

p h o n e s , e a c h e a r h e a r s o n l y t h e s t e r e o c h a n n e l c o r r e s p o n d i n g t o i t . T h e l e f t e a r h e a r s

o n l y t h e l e f t c h a n n e l a n d t h e r i g h t e a r h e a r s o n l y t h e r i g h t c h a n n e l . T h e r e s u l t i s t h a t

s o u n d f r o m h e a d p h o n e s d o e s n o t p r o v i d e t h e s a m e s p a t i a l c u e s t o y o u r e a r a n d b r a i n a s

s p e a k e r s , a n d m i g h t f o r t h a t r e a s o n s o u n d u n n a t u r a l t o s o m e l i s t e n e r s .

T h e c r o s s f e e d f u n c t i o n u s e s a n a l g o r i t h m t o f e e d a d e l a y e d a n d l t e r e d p o r t i o n o f t h e

s i g n a l f r o m t h e r i g h t c h a n n e l i n t o t h e l e f t c h a n n e l a n d v i c e v e r s a i n o r d e r t o s i m u l a t e t h e

s p a t i a l c u e s t h a t t h e e a r a n d b r a i n r e c e i v e w h e n l i s t e n i n g t o a s e t o f l o u d s p e a k e r s p l a c e d

i n f r o n t o f t h e l i s t e n e r . T h e r e s u l t i s a m o r e n a t u r a l s t e r e o i m a g e t h a t c a n b e e s p e c i a l l y

a p p r e c i a t e d i n o l d e r r o c k a n d j a z z r e c o r d s , w h e r e o n e i n s t r u m e n t i s o f t e n h a r d - p a n n e d

t o j u s t o n e o f t h e s p e a k e r s . M a n y p e o p l e w i l l n d s u c h r e c o r d s t i r i n g t o l i s t e n t o u s i n g

e a r p h o n e s a n d n o c r o s s f e e d e e c t .

C r o s s f e e d h a s t h e f o l l o w i n g s e t t i n g s :

C r o s s f e e d . S e l e c t s w h e t h e r t h e c r o s s f e e d e e c t i s t o b e e n a b l e d o r n o t .

D i r e c t G a i n . H o w m u c h t h e l e v e l o f t h e a u d i o t h a t t r a v e l s t h e d i r e c t p a t h f r o m a s p e a k e r

t o t h e c o r r e s p o n d i n g e a r i s s u p p o s e d t o b e d e c r e a s e d .

C r o s s G a i n . H o w m u c h t h e l e v e l o f t h e a u d i o t h a t t r a v e l s t h e c r o s s p a t h f r o m a s p e a k e r

t o t h e o p p o s i t e e a r i s t o b e d e c r e a s e d .

H i g h - F r e q u e n c y A t t e n u a t i o n . H o w m u c h t h e u p p e r f r e q u e n c i e s o f t h e c r o s s p a t h a u d i o

w i l l b e d a m p e n e d . N o t e t h a t t h e t o t a l l e v e l o f t h e h i g h e r f r e q u e n c i e s w i l l b e a

c o m b i n a t i o n o f b o t h t h i s s e t t i n g a n d t h e C r o s s G a i n s e t t i n g .

H i g h - F r e q u e n c y C u t o . D e c i d e s a t w h i c h f r e q u e n c y t h e c r o s s p a t h a u d i o w i l l s t a r t t o

b e c u t b y t h e a m o u n t d e s c r i b e d b y t h e H i g h - F r e q u e n c y A t t e n u a t i o n s e t t i n g .





M o s t u s e r s w i l l n d t h e d e f a u l t s e t t i n g s t o y i e l d s a t i s f a c t o r y r e s u l t s , b u t f o r t h e m o r e

a d v e n t u r o u s u s e r t h e s e t t i n g s c a n b e n e - t u n e d t o p r o v i d e a v i r t u a l s p e a k e r p l a c e m e n t

s u i t e d t o o n e s p r e f e r e n c e . B e w a r e t h a t t h e c r o s s f e e d f u n c t i o n i s c a p a b l e o f m a k i n g t h e

a u d i o d i s t o r t i f y o u c h o o s e s e t t i n g s w h i c h r e s u l t i n a t o o h i g h o u t p u t l e v e l .

6 . 8 . E q u a l i z e r

F i g u r e 6 . 2 . : T h e g r a p h i c a l e q u a l i z e r

R o c k b o x f e a t u r e s a p a r a m e t r i c e q u a l i z e r ( E Q ) . A s t h e n a m e s u g g e s t s , a p a r a m e t r i c E Q

l e t s y o u c o n t r o l s e v e r a l d i e r e n t p a r a m e t e r s f o r e a c h b a n d o f t h e E Q . I n s o m e w a y s t h e

E Q i s s i m i l a r t o t h e B a s s a n d T r e b l e s e t t i n g s d e s c r i b e d e a r l i e r , b u t t h e E Q a l l o w s y o u

t o c o n t r o l t h e s o u n d m u c h m o r e c a r e f u l l y .

R o c k b o x ' s p a r a m e t r i c E Q i s c o m p o s e d o f v e d i e r e n t b a n d s :

B a n d 0 : L o w s h e l f l t e r . T h e l o w s h e l f l t e r b o o s t s o r l o w e r s a l l f r e q u e n c i e s b e l o w a

c e r t a i n f r e q u e n c y l i m i t , m u c h a s t h e b a s s c o n t r o l f o u n d o n o r d i n a r y s t e r e o s y s t e m s

d o e s . A d j u s t t h e c u t o f r e q u e n c y p a r a m e t e r t o d e c i d e w h e r e t h e s h e l v i n g s t a r t s

t o t a k e e e c t . F o r e x a m p l e , a c u t o f r e q u e n c y o f 5 0 H z w i l l a d j u s t o n l y v e r y

l o w f r e q u e n c i e s . A c u t o f r e q u e n c y o f 2 0 0 H z , o n t h e o t h e r h a n d , w i l l a d j u s t a

m u c h w i d e r r a n g e o f b a s s f r e q u e n c i e s . T h e g a i n p a r a m e t e r c o n t r o l s h o w m u c h

t h e l o u d n e s s o f t h e b a n d i s a d j u s t e d . P o s i t i v e n u m b e r s m a k e t h e E Q b a n d l o u d e r ,

w h i l e n e g a t i v e n u m b e r s m a k e t h a t E Q b a n d q u i e t e r . T h e Q p a r a m e t e r s h o u l d





a l w a y s b e s e t t o 0 . 7 f o r t h e s h e l v i n g l t e r s . H i g h e r v a l u e s w i l l a d d a s m a l l b o o s t

a r o u n d t h e c u t o f r e q u e n c y t h a t i s a l m o s t a l w a y s u n d e s i r a b l e .

B a n d s 1 - 3 : P e a k i n g l t e r s . P e a k i n g E Q l t e r s b o o s t o r l o w e r a f r e q u e n c y r a n g e c e n -

t e r e d a t t h e c e n t r e f r e q u e n c y c h o s e n . G r a p h i c e q u a l i z e r s i n h o m e s t e r e o s a r e u s u a l l y

p e a k i n g l t e r s . T h e p e a k i n g l t e r s i n R o c k b o x ' s E Q l e t s y o u a d j u s t t h r e e d i e r e n t

p a r a m e t e r s f o r E Q b a n d s 1 t h r o u g h 3 . T h e c e n t r e p a r a m e t e r c o n t r o l s t h e c e n t r e

f r e q u e n c y o f t h e f r e q u e n c y r a n g e t h a t i s a e c t e d a s d e s c r i b e d a b o v e . T h e g a i n

p a r a m e t e r c o n t r o l s h o w m u c h e a c h b a n d i s a d j u s t e d , a n d w o r k s a s f o r t h e l o w s h e l f

l t e r . F i n a l l y , t h e Q p a r a m e t e r c o n t r o l s h o w w i d e o r n a r r o w t h e a e c t e d f r e -

q u e n c y r a n g e i s . H i g h e r Q v a l u e s w i l l a e c t a n a r r o w e r b a n d o f f r e q u e n c i e s , w h i l e

l o w e r Q v a l u e s w i l l a e c t a w i d e r b a n d o f f r e q u e n c i e s .

B a n d 4 : H i g h s h e l f l t e r . A h i g h s h e l f l t e r b o o s t s o r l o w e r s a l l f r e q u e n c i e s a b o v e a c e r -

t a i n f r e q u e n c y l i m i t , m u c h a s t h e t r e b l e c o n t r o l f o u n d o n o r d i n a r y s t e r e o s y s t e m s

d o e s . T h e h i g h s h e l f l t e r i s a d j u s t e d t h e s a m e w a y a s t h e l o w s h e l f l t e r , e x c e p t

t h a t i t w o r k s o n t h e h i g h e n d o f t h e f r e q u e n c y s p e c t r u m r a t h e r t h a n t h e l o w e n d .

A s a g e n e r a l g u i d e , E Q b a n d 0 s h o u l d b e u s e d f o r l o w f r e q u e n c i e s , E Q b a n d s 1 t h r o u g h

3 s h o u l d b e u s e d f o r m i d s , a n d E Q b a n d 4 s h o u l d b e u s e d f o r h i g h s .

E n a b l e E Q . T h i s o p t i o n c o n t r o l s w h e t h e r t h e E Q i s o n o r o .

G r a p h i c a l E Q . T h i s o p t i o n b r i n g s u p a g r a p h i c E Q s c r e e n , w h i c h a l l o w s a d j u s t m e n t o f

e a c h o f t h e t h r e e p a r a m e t e r s d e s c r i b e d a b o v e ( g a i n , c e n t r e f r e q u e n c y , a n d Q ) f o r

e a c h o f t h e v e E Q b a n d s .


R i g h t F o r w a r d R a i s e s t h e h i g h l i g h t e d p a r a m e t e r .

L e f t R e w i n d L o w e r s t h e h i g h l i g h t e d p a r a m e t e r .

U p V o l u m e U p M o v e s t o t h e p r e v i o u s E Q b a n d .

D o w n V o l u m e D o w n M o v e s t o t h e n e x t E Q b a n d .

S e l e c t P l a y T o g g l e s t h e c u r s o r a m o n g t h e t h r e e p a -

r a m e t e r s ( g a i n , c e n t r e f r e q u e n c y , Q ) f o r

t h e s e l e c t e d E Q b a n d

P o w e r M e n u E x i t s t h e g r a p h i c E Q s c r e e n .

P r e - c u t . I f t o o m u c h g a i n i s a d d e d t h r o u g h t h e g r a p h i c a l E Q , y o u r m u s i c m a y d i s t o r t .

T h e P r e c u t s e t t i n g a l l o w s y o u t o a d j u s t t h e o v e r a l l g a i n o f t h e E Q .

I f y o u r m u s i c d i s t o r t s w h e n u s i n g t h e E Q , t r y i n g c h a n g i n g t h i s s e t t i n g t o a n e g a t i v e

v a l u e .





S i m p l e E Q . T h i s o p t i o n p r o v i d e s a n e a s i e r a l t e r n a t i v e f o r t h o s e w h o a r e d a u n t e d b y a l l

o f t h e p a r a m e t e r s t h a t c a n b e a d j u s t e d u s i n g t h e g r a p h i c a l E Q . W i t h t h e S i m p l e

E Q , t h e o n l y p a r a m e t e r t h a t c a n b e a d j u s t e d i s t h e g a i n .

A d v a n c e d E Q . T h i s s u b m e n u p r o v i d e s o p t i o n s f o r a d j u s t i n g t h e s a m e p a r a m e t e r s a s t h e

G r a p h i c a l E Q . T h e o n l y d i e r e n c e i s t h a t t h e p a r a m e t e r s a r e a d j u s t e d t h r o u g h

t e x t u a l m e n u s r a t h e r t h a n t h r o u g h a g r a p h i c i n t e r f a c e .

S a v e E Q P r e s e t . T h i s o p t i o n s a v e s t h e c u r r e n t E Q c o n g u r a t i o n i n a . c f g l e .

B r o w s e E Q P r e s e t s . T h i s m e n u d i s p l a y s a l i s t o f E Q p r e s e t s , a s w e l l a s a n y E Q c o n -

g u r a t i o n s s a v e d u s i n g t h e S a v e E Q P r e s e t o p t i o n . U s e r s u n f a m i l i a r w i t h t h e

o p e r a t i o n o f a p a r a m e t r i c E Q m a y w i s h t o u s e t h e p r e s e t s i n s t e a d o f t r y i n g t o

c o n g u r e t h e E Q , o r u s e t h e p r e s e t s f o r d e s i g n i n g t h e i r o w n c u s t o m E Q s e t t i n g s .

6 . 9 . D i t h e r i n g

T h i s s e t t i n g c o n t r o l s t h e d i t h e r i n g a n d n o i s e s h a p i n g f u n c t i o n a l i t y o f R o c k b o x .

M o s t o f R o c k b o x ' a u d i o l e d e c o d e r s w o r k a t a h i g h e r b i t d e p t h t h a n t h e 1 6 b i t s u s e d

f o r o u t p u t o n t h e p l a y e r ' s a u d i o c o n n e c t o r s . T h e s i m p l e s t w a y t o c o n v e r t f r o m o n e b i t

d e p t h t o a n o t h e r i s s i m p l y d i s c a r d i n g a l l t h e s u r p l u s b i t s . T h i s i s t h e d e f a u l t b e h a v i o u r ,

a n d a d d s d i s t o r t i o n t o t h e s i g n a l t h a t w i l l v a r y i n c h a r a c t e r a l o n g w i t h t h e d e s i r e d s o u n d .

D i t h e r i n g a d d s l o w - l e v e l n o i s e t o t h e s i g n a l p r i o r t o t h r o w i n g a w a y t h e s u r p l u s b i t s ,

w h i c h g i v e s t h e r e s u l t i n g s i g n a l a u n i f o r m n o i s e o o r w h i c h i s i n d e p e n d e n t o f t h e s i g -

n a l . M o s t p e o p l e n d t h i s n o i s e p r e f e r a b l e t o t h e t i m e - v a r y i n g n o i s e h e a r d w h e n n o t

p e r f o r m i n g d i t h e r i n g .

A f t e r d i t h e r i n g , n o i s e s h a p i n g i s p e r f o r m e d . T h i s b a s i c a l l y j u s t p u s h e s t h e d i t h e r i n g

n o i s e t o t h e p a r t s o f t h e f r e q u e n c y s p e c t r u m h u m a n s c a n n o t h e a r s o e a s i l y . I n R o c k b o x '

c a s e , s o m e o f t h e n o i s e i s p u s h e d u p t o a b o v e 1 0 k H z .

T h i s s e t t i n g w i l l b e p u t t o i t s b e s t u s e w h e n l i s t e n i n g t o d y n a m i c m u s i c w i t h f r e q u e n t l y

o c c u r i n g q u i e t p a r t s , c l a s s i c a l m u s i c b e i n g a t y p i c a l e x a m p l e . I t i s w o r t h n o t i n g t h a t t h e

e e c t s o f d i t h e r i n g a n d n o i s e s h a p i n g a r e v e r y s u b t l e , a n d n o t e a s i l y n o t i c a b l e .

R o c k b o x u s e s h i g h p a s s t r i a n g u l a r d i s t r i b u t i o n n o i s e a s t h e d i t h e r i n g n o i s e s o u r c e , a n d

a t h i r d o r d e r n o i s e s h a p e r .

6 . 1 0 . T i m e s t r e t c h

E n a b l i n g T i m e s t r e t c h a l l o w s y o u t o c h a n g e t h e p l a y b a c k s p e e d w i t h o u t i t a e c t i n g t h e

p i t c h o f t h e r e c o r d i n g . A f t e r e n a b l i n g t h i s f e a t u r e a n d r e b o o t i n g , y o u c a n a c c e s s t h i s v i a

t h e P i t c h S c r e e n . T h i s f u n c t i o n i s i n t e n d e d f o r s p e e c h p l a y b a c k a n d m a y s i g n i c a n t l y

d i l u t e y o u r l i s t e n i n g e x p e r i e n c e w i t h m o r e c o m p l e x a u d i o . S e e s e c t i o n 4 . 3 . 3 ( p a g e 3 4 ) f o r

m o r e d e t a i l s a b o u t h o w t o u s e t h e f e a t u r e .





6 . 1 1 . C o m p r e s s o r

T h e C o m p r e s s o r r e d u c e s , o r c o m p r e s s e s , t h e d y n a m i c r a n g e o f t h e a u d i o s i g n a l . T h i s

m a k e s t h e q u i e t e r a n d l o u d e r s e c t i o n s c l o s e r t o t h e s a m e v o l u m e l e v e l b y p r o g r e s s i v e l y

r e d u c i n g t h e g a i n o f l o u d e r s i g n a l s . W h e n s u b s e q u e n t l y a m p l i e d , t h i s h a s t h e e e c t o f

m a k i n g t h e q u i e t e r s e c t i o n s l o u d e r w h i l e k e e p i n g t h e l o u d e r s e c t i o n s f r o m c l i p p i n g . T h i s

a l l o w s l i s t e n i n g t o t h e q u i e t s e c t i o n s o f d y n a m i c m a t e r i a l i n n o i s y e n v i r o n m e n t s w h i l e

p r e v e n t i n g s u d d e n l o u d s e c t i o n s f r o m b e i n g o v e r b e a r i n g .

T h e r e a r e s e v e r a l s e t t i n g s a s s o c i a t e d w i t h t h e c o m p r e s s o r . T h e r s t , a n d m o s t i m p o r -

t a n t , i s t h e T h r e s h o l d . T h e t h r e s h o l d i s t h e a u d i o i n p u t l e v e l a t w h i c h t h e c o m p r e s s o r

b e g i n s t o a c t . A n y l e v e l l o u d e r t h a n t h e t h r e s h o l d w i l l b e c o m p r e s s e d t o s o m e e x t e n t .

T h e m a x i m u m a m o u n t o f c o m p r e s s i o n , o r t h e q u i e t e s t l e v e l a t w h i c h t h e c o m p r e s s o r w i l l

o p e r a t e , i s - 2 4 d B . T h e d e f a u l t o f O d i s a b l e s t h e c o m p r e s s o r .

T h e M a k e u p G a i n s e t t i n g h a s t w o o p t i o n s : O a n d A u t o . O m e a n s t h a t t h e

c o m p r e s s e d a u d i o w i l l n o t b e a m p l i e d a f t e r c o m p r e s s i o n . T h e d e f a u l t o f A u t o w i l l

a m p l i f y t h e s i g n a l s o t h a t t h e l o u d e s t p o s s i b l e s i g n a l a f t e r c o m p r e s s i o n w i l l b e j u s t u n d e r

t h e c l i p p i n g l i m i t . T h i s i s d e s i r a b l e b e c a u s e t h e c o m p r e s s e d s i g n a l w i t h o u t m a k e u p g a i n i s

q u i e t e r t h a n t h e i n p u t s i g n a l . M a k e u p G a i n i n A u t o r e s t o r e s t h e s i g n a l t o t h e m a x i m u m

p o s s i b l e l e v e l a n d b r i n g s t h e q u i e t e r a u d i o u p w i t h i t . T h i s i s w h a t m a k e s i t p o s s i b l e t o

h e a r t h e q u i e t e r a u d i o i n n o i s y e n v i r o n m e n t s .

T h e R a t i o s e t t i n g d e t e r m i n e s h o w a g g r e s s i v e l y t h e c o m p r e s s o r r e d u c e s g a i n a b o v e t h e

t h r e s h o l d . F o r e x a m p l e , t h e 2 : 1 s e t t i n g m e a n s t h a t f o r e a c h t w o d e c i b e l s o f i n p u t s i g n a l

a b o v e t h e t h r e s h o l d , t h e c o m p r e s s o r w i l l o n l y a l l o w t h e o u t p u t t o a p p e a r a s o n e d e c i b e l .

T h e h i g h e r t h e r a t i o , t h e h a r d e r t h e s i g n a l i s c o m p r e s s e d . T h e r a t i o s e t t i n g o f L i m i t

m e a n s e s s e n t i a l l y a r a t i o o f i n n i t y t o o n e . I n t h i s c a s e , t h e o u t p u t s i g n a l i s n o t a l l o w e d

t o e x c e e d t h e t h r e s h o l d a t a l l .

T h e K n e e s e t t i n g d e t e r m i n e s h o w a b r u p t t h e t r a n s i t i o n i s f r o m a n o n - c o m p r e s s e d

s i g n a l t o a c o m p r e s s e d s i g n a l . H a r d K n e e m e a n s t h a t t h e t r a n s i t i o n o c c u r s p r e c i s e l y a t

t h e t h r e s h o l d . T h e S o f t K n e e s e t t i n g s m o o t h e s t h e t r a n s i t i o n f r o m p l u s o r m i n u s t h r e e

d e c i b e l s a r o u n d t h e t h r e s h o l d .

T h e R e l e a s e T i m e s e t t i n g s e t s t h e r e c o v e r y t i m e a f t e r t h e s i g n a l i s c o m p r e s s e d . O n c e

t h e c o m p r e s s o r d e t e r m i n e s t h a t c o m p r e s s i o n i s n e c e s s a r y , t h e i n p u t s i g n a l i s r e d u c e d

a p p r o p r i a t e l y , b u t t h e g a i n i s n ' t a l l o w e d t o i m m e d i a t e l y r e t u r n t o n o r m a l l e v e l s . T h i s i s

n e c e s s a r y t o r e d u c e a r t i f a c t s s u c h a s p u m p i n g . I n s t e a d , t h e g a i n i s a l l o w e d t o r e t u r n t o

n o r m a l a t t h e c h o s e n r a t e . R e l e a s e T i m e i s t h e t i m e f o r t h e g a i n t o r e c o v e r b y 1 0 d B .




C h a p t e r 7 . P l a y b a c k S e t t i n g s 5 5

7 . 3 . P l a y S e l e c t e d F i r s t

T h i s s e t t i n g c o n t r o l s w h a t h a p p e n s w h e n y o u s e l e c t a l e f o r p l a y b a c k w h i l e s h u e m o d e

i s o n . I f t h e P l a y S e l e c t e d F i r s t s e t t i n g i s Y e s , t h e l e y o u s e l e c t e d w i l l b e p l a y e d

r s t . I f t h i s s e t t i n g i s N o , a r a n d o m l e i n t h e d i r e c t o r y w i l l b e p l a y e d r s t .

7 . 4 . F a s t - F o r w a r d / R e w i n d

T h e s e s e t t i n g s c o n t r o l t h e s p e e d a n d a c c e l e r a t i o n d u r i n g f a s t f o r w a r d a n d r e w i n d . T h e

s e t t i n g F F / R W M i n S t e p c o n t r o l s t h e i n i t i a l s p e e d a n d F F / R W A c c e l c o n t r o l s t h e

a c c e l e r a t i o n .

7 . 5 . A n t i - S k i p B u e r

T h i s s e t t i n g c o n t r o l s h o w e a r l y R o c k b o x s t a r t s r e l l i n g t h e m u s i c b u e r f r o m t h e h a r d

d r i v e w h e n p l a y i n g . A l o n g e r A n t i - S k i p B u e r h e l p s p r e v e n t s k i p s i n m u s i c p l a y b a c k i f

R o c k b o x h a s t r o u b l e r e a d i n g f r o m t h e d i s k . T h i s c a n h a p p e n i f t h e p l a y e r i s k n o c k e d ,

s h a k e n o r j o g g e d h e a v i l y w h i l e R o c k b o x i s t r y i n g t o r e a d t h e h a r d d r i v e .

T h e a n t i - s k i p b u e r c a n b e s e t t o v a r i o u s v a l u e s b e t w e e n 5 s e c o n d s a n d 1 0 m i n u t e s .

N o t e : H a v i n g a l a r g e a n t i - s k i p b u e r t e n d s t o u s e m o r e p o w e r , a n d m a y r e d u c e y o u r bb a t t e r y l i f e . I t i s r e c o m m e n d e d t o a l w a y s u s e t h e l o w e s t p o s s i b l e s e t t i n g t h a t a l l o w s

c o r r e c t a n d c o n t i n u o u s p l a y b a c k .

7 . 6 . F a d e o n S t o p / P a u s e

E n a b l e s a n d d i s a b l e s a f a d e e e c t w h e n y o u p a u s e o r s t o p p l a y i n g a s o n g . I f t h e F a d e

o n S t o p / P a u s e o p t i o n i s s e t t o Y e s , y o u r m u s i c w i l l f a d e o u t w h e n y o u s t o p o r p a u s e

p l a y b a c k , a n d f a d e i n w h e n y o u r e s u m e p l a y b a c k .

7 . 7 . P a r t y M o d e

E n a b l e s u n s t o p p a b l e m u s i c p l a y b a c k . W h e n n e w s o n g s a r e s e l e c t e d , t h e y a r e q u e u e d a t

t h e e n d o f t h e c u r r e n t d y n a m i c p l a y l i s t i n s t e a d o f b e i n g p l a y e d i m m e d i a t e l y . P a u s i n g

a n d s t o p p i n g p l a y b a c k i s d i s a b l e d a s w e l l a s s k i p p i n g s o n g s a n d l a u n c h i n g p l u g i n s .

7 . 8 . C r o s s f a d e

T h i s s e c t i o n c o n t r o l s t h e b e h a v i o r o f t h e c r o s s f a d e r . T h e c r o s s f a d e r , w h e n e n a b l e d ,

s m o o t h l y f a d e s o n e t r a c k i n t o t h e n e x t . T h i s c a n o c c u r i n t w o s i t u a t i o n s : a n a u t o m a t i c

t r a c k c h a n g e o r a m a n u a l t r a c k s k i p . A n a u t o m a t i c t r a c k c h a n g e o c c u r s a t t h e e n d o f





t h e t r a c k , m o v i n g t o t h e n e x t t r a c k i n t h e p l a y l i s t w i t h o u t u s e r i n t e r v e n t i o n . A m a n -

u a l t r a c k s k i p g o e s t o t h e n e x t t r a c k i m m e d i a t e l y w h e n t h e a p p r o p r i a t e b u t t o n i s p r e s s e d .

O p t i o n s f o r c r o s s f a d e s e t t i n g s a r e :

E n a b l e C r o s s f a d e . I f s e t t o O f f , c r o s s f a d e i s d i s a b l e d a n d a l l t r a c k c h a n g e s a r e g a p l e s s .

I f s e t t o A u t o m a t i c T r a c k C h a n g e O n l y , c r o s s f a d e o c c u r s f o r a u t o m a t i c t r a c k

c h a n g e s , b u t n o t f o r m a n u a l t r a c k s k i p s . T h e n e x t s e t t i n g , M a n u a l T r a c k S k i p

O n l y , i s t h e o p p o s i t e : t r a c k s w i l l o n l y c r o s s f a d e w h e n m a n u a l l y s k i p p e d . I f s e t t o

S h u f f l e , c r o s s f a d e i s e n a b l e d f o r a l l t r a c k c h a n g e s , a u t o m a t i c o r m a n u a l , w h e n

t h e s h u e f e a t u r e i s s e t t o Y e s , b u t d i s a b l e d o t h e r w i s e . I f s e t t o S h u f f l e o r

M a n u a l T r a c k S k i p t h e n c r o s s f a d e w i l l b e a c t i v e e i t h e r w h e n s h u e i s s e t t o

Y e s o r t h e t r a c k i s m a n u a l l y s k i p p e d . I f s e t t o A l w a y s , t r a c k s w i l l a l w a y s c r o s s f a d e

i n t o o n e a n o t h e r .

F a d e I n D e l a y . T h e f a d e i n d e l a y i s t h e l e n g t h o f t i m e b e t w e e n w h e n t h e c r o s s f a d e

p r o c e s s b e g i n s a n d w h e n t h e n e w t r a c k b e g i n s t o f a d e i n .

F a d e I n D u r a t i o n . T h e l e n g t h o f t i m e , i n s e c o n d s , t h a t i t t a k e s y o u r m u s i c t o f a d e i n

o n c e t h e F a d e I n D e l a y h a s e n d e d .

F a d e O u t D e l a y . T h e f a d e o u t d e l a y i s t h e l e n g t h o f t i m e b e t w e e n w h e n t h e c r o s s f a d e

p r o c e s s b e g i n s a n d w h e n t h e o l d t r a c k b e g i n s t o f a d e o u t .

F a d e O u t D u r a t i o n . T h e l e n g t h o f t i m e , i n s e c o n d s , t h a t i t t a k e s y o u r m u s i c t o f a d e o u t

o n c e t h e F a d e O u t D e l a y h a s e n d e d .

F a d e O u t M o d e . I f s e t t o C r o s s f a d e , o n e s o n g w i l l f a d e o u t a n d t h e n e x t s o n g w i l l

s i m u l t a n e o u s l y f a d e i n . I f s e t t o M i x , t h e e n d i n g s o n g w i l l n o t f a d e o u t a t a l l , a n d

w i l l c o n t i n u e t o p l a y a s n o r m a l u n t i l i t s e n d w i t h t h e s t a r t i n g s o n g f a d i n g i n f r o m

u n d e r i t . M i x m o d e i s n o t u s e d f o r m a n u a l t r a c k s k i p s , e v e n i f i t i s s e l e c t e d h e r e .

N o t e : T h e r u l e s a b o v e a p p l y e x c e p t i n t h e i n s t a n c e w h e r e F a d e O u t D e l a y p l u s F a d e bO u t D u r a t i o n i s l e s s t h e n F a d e I n D e l a y ( w h i c h w o u l d c r e a t e a g a p i n t h e a u d i o ) .

I n t h i s c a s e , t h e F a d e I n D e l a y i s r e d u c e d t o e l i m i n a t e t h e g a p .

T h e g r a p h i c b e l o w i l l u s t r a t e s h o w t h e d i e r e n t s e t t i n g s w o r k i n p r a c t i c e .





7 . 9 . R e p l a y g a i n

T h i s a l l o w s y o u t o c o n t r o l t h e r e p l a y g a i n f u n c t i o n . T h e p u r p o s e o f r e p l a y g a i n i s t o a d j u s t

t h e v o l u m e o f t h e m u s i c p l a y e d s o t h a t a l l s o n g s ( o r a l b u m s , d e p e n d i n g o n y o u r s e t t i n g s )

h a v e t h e s a m e a p p a r e n t v o l u m e . T h i s p r e v e n t s s u d d e n c h a n g e s i n v o l u m e w h e n c h a n g i n g

b e t w e e n s o n g s r e c o r d e d a t d i e r e n t v o l u m e l e v e l s . F o r r e p l a y g a i n t o w o r k , t h e s o n g s

m u s t h a v e b e e n p r o c e s s e d b y a p r o g r a m t h a t a d d s r e p l a y g a i n i n f o r m a t i o n t o t h e I D 3

t a g s ( o r V o r b i s t a g s ) .

N o t e : A P E v 2 t a g s a r e n o t c u r r e n t l y s u p p o r t e d . b

O p t i o n s f o r r e p l a y g a i n a r e :

R e p l a y g a i n T y p e . C h o o s e t h e t y p e o f r e p l a y g a i n t o a p p l y :

A l b u m G a i n . M a i n t a i n a c o n s t a n t v o l u m e l e v e l b e t w e e n a l b u m s , b u t k e e p a n y

i n t e n t i o n a l v o l u m e v a r i a t i o n s b e t w e e n s o n g s i n a n a l b u m . ( I f a l b u m g a i n

v a l u e i s n o t a v a i l a b l e , u s e s t r a c k g a i n i n f o r m a t i o n ) .

T r a c k G a i n . M a i n t a i n a c o n s t a n t v o l u m e l e v e l b e t w e e n t r a c k s . I f t r a c k g a i n v a l u e

i s n o t a v a i l a b l e , n o r e p l a y g a i n i s a p p l i e d .

T r a c k G a i n I f S h u i n g . M a i n t a i n s a c o n s t a n t v o l u m e b e t w e e n t r a c k s i f S h u f f l e

i s s e t t o Y e s . R e v e r t s t o a l b u m m o d e i f S h u f f l e i s s e t t o N o .

O . D o n o t p r o c e s s r e p l a y g a i n i n f o r m a t i o n , i . e . t u r n o t h e r e p l a y g a i n f u n c t i o n .





P r e v e n t C l i p p i n g . A v o i d c l i p p i n g o f a s o n g ' s w a v e f o r m . I f a s o n g w o u l d c l i p d u r i n g

p l a y b a c k , t h e v o l u m e i s l o w e r e d f o r t h a t s o n g . R e p l a y g a i n i n f o r m a t i o n i s n e e d e d

f o r t h i s t o w o r k .

P r e - a m p . T h i s a l l o w s y o u t o a d j u s t t h e v o l u m e w h e n r e p l a y g a i n i s a p p l i e d . R e p l a y g a i n

o f t e n l o w e r s t h e v o l u m e , s o m e t i m e s q u i t e m u c h , s o h e r e y o u c a n c o m p e n s a t e f o r

t h a t . P l e a s e n o t e t h a t a ( l a r g e ) p o s i t i v e p r e - a m p s e t t i n g c a n c a u s e c l i p p i n g , u n l e s s

p r e v e n t c l i p p i n g i s e n a b l e d . T h e p r e - a m p c a n b e s e t t o a n y d e c i b e l ( d B ) v a l u e

b e t w e e n - 1 2 d B a n d + 1 2 d B , i n i n c r e m e n t s o f 0 . 5 d B .

7 . 1 0 . T r a c k S k i p B e e p

C o n t r o l s t h e v o l u m e o f t h e b e e p t h a t i s h e a r d w h e n s k i p p i n g f o r w a r d o r b a c k w a r d b e t w e e n

t r a c k s . T h e b e e p i s d i s a b l e d w h e n s e t t o O f f .

7 . 1 1 . A u t o - C h a n g e D i r e c t o r y

C o n t r o l w h a t R o c k b o x d o e s w h e n i t r e a c h e s t h e e n d o f a d i r e c t o r y . I f A u t o - C h a n g e D i -

r e c t o r y i s s e t t o Y e s , R o c k b o x w i l l c o n t i n u e t o t h e n e x t d i r e c t o r y . I f A u t o - C h a n g e

D i r e c t o r y i s s e t t o N o , p l a y b a c k w i l l s t o p a t t h e e n d o f t h e c u r r e n t p l a y l i s t . U s i n g

t h e R a n d o m f e a t u r e r e q u i r e s y o u t o r s t g e n e r a t e a f o l d e r l i s t v i a t h e R a n d o m F o l d e r

A d v a n c e C o n g u r a t i o n p l u g i n ( s e e s e c t i o n 1 0 . 4 . 1 3 ( p a g e 1 5 9 ) ) .

N o t e : Y o u m u s t h a v e t h e R e p e a t o p t i o n s e t t o N o f o r A u t o - C h a n g e D i r e c t o r y t o bf u n c t i o n p r o p e r l y .

N o t e : T h i s f e a t u r e o n l y w o r k s w h e n s o n g s h a v e b e e n p l a y e d f r o m t h e l e b r o w s e r . U s i n g bi t w i t h t h e d a t a b a s e m a y c a u s e u n e x p e c t e d b e h a v i o u r .

7 . 1 2 . P a u s e o n H e a d p h o n e U n p l u g

E n a b l e s a n d d i s a b l e s a u t o m a t i c p a u s i n g o f p l a y b a c k w h e n t h e h e a d p h o n e s a r e d i s c o n -

n e c t e d f r o m t h e p l a y e r ' s h e a d p h o n e s o c k e t .

P a u s e o n H e a d p h o n e U n p l u g . O p t i o n s f o r a u t o m a t i c p a u s e :

O . D i s a b l e s a u t o m a t i c p a u s e .

P a u s e . P a u s e s t h e p l a y e r w h e n t h e h e a d p h o n e s a r e r e m o v e d .

P a u s e a n d R e s u m e . P a u s e s w h e n t h e h e a d p h o n e s a r e r e m o v e d , a n d r e s u m e s p l a y -

b a c k w h e n t h e y a r e r e c o n n e c t e d .

D u r a t i o n t o R e w i n d . N u m b e r o f s e c o n d s ( b e t w e e n 0 a n d 1 5 ) t o r e w i n d p l a y b a c k w h e n

t h e h e a d p h o n e s a r e r e m o v e d .





D i s a b l e A u t o - R e s u m e I f P h o n e s N o t P r e s e n t . T h i s o p t i o n w i l l d i s a b l e t h e a u t o m a t i c

r e s u m p t i o n o f p l a y b a c k a t s t a r t u p i f t h e h e a d p h o n e s a r e n o t c o n n e c t e d t o t h e

p l a y e r .

N o t e : T h i s r e q u i r e s R e s u m e o n S t a r t u p t o b e e n a b l e d .

b7 . 1 3 . L a s t . f m L o g

E n a b l e s l o g g i n g o f y o u r p l a y e d t r a c k s f o r s u b m i t t a l t o h t t p : / / w w w . l a s t . f m . T h i s s e r v i c e

w a s f o r m e l y k n o w n a s A u d i o s c r o b b l e r . W h e n y o u e n a b l e t h i s o p t i o n , y o u ' l l h a v e t o r e b o o t

t o s t a r t t h e l o g g i n g . T h e l o g - l e i s c a l l e d . s c r o b b l e r . l o g , a n d i s t o b e f o u n d i n t h e r o o t

d i r e c t o r y o f y o u r p l a y e r .

N o t e : S e e ZL a s t F M L o g f o r a f u r t h e r d e s c r i p t i o n , a n d f o r t o o l s y o u c a n u s e t o s u b m i t by o u r L a s t . f m l o g .

7 . 1 4 . C u e s h e e t S u p p o r t

E n a b l e s r e a d i n g o f c u e s h e e t l e s f o r p l a y e d t r a c k s . I f a c u e s h e e t i s f o u n d f o r a t r a c k ,

t r a c k m a r k e r s a r e d i s p l a y e d o n t h e p r o g r e s s b a r a n d i t i s p o s s i b l e t o s k i p b e t w e e n t h e

t r a c k s w i t h i n t h e c u e s h e e t . A l s o t h e i n f o r m a t i o n f o u n d i n t h e c u e s h e e t l e w i l l r e p l a c e

t h e i n f o r m a t i o n f r o m t h e I D 3 t a g s . W h e n y o u e n a b l e t h i s o p t i o n , y o u ' l l h a v e t o r e b o o t

f o r i t t o c o m e i n t o e e c t .

7 . 1 5 . S k i p L e n g t h

D e s i g n e d t o s p e e d u p n a v i g a t i o n w h e n l i s t e n i n g t o l o n g a u d i o t r a c k s , S k i p L e n g t h

c h a n g e s t h e b e h a v i o u r o f t h e L e f t a n d R i g h t b u t t o n s s o t h a t t h e y s k i p b y a g i v e n t i m e

i n s t e a d o f s k i p p i n g t o a n e w t r a c k . T h e S k i p t o O u t r o o p t i o n c h a n g e s t h e b e h a v i o u r

s o t h a t t h e b u t t o n s s k i p t o j u s t b e f o r e t h e e n d o f t h e t r a c k , s o t h a t t h e l a s t f e w s e c o n d s

a r e p l a y e d b e f o r e t h e n e x t t r a c k .

7 . 1 6 . P r e v e n t T r a c k S k i p p i n g

I f t h i s o p t i o n i s e n a b l e d , t h e a b i l i t y t o m a n u a l l y s k i p t r a c k s i s d i s a b l e d i n o r d e r t o a v o i d

a c c i d e n t a l t r a c k s k i p s . I t d o e s n o t p r e v e n t c h a n g i n g t r a c k s i f a t r a c k e n d s , w h i c h c a n b e

a c h i e v e d b y c o m b i n i n g t h i s o p t i o n w i t h R e p e a t s e t t o O n e

7 . 1 7 . R e w i n d B e f o r e R e s u m e

W h e n r e s u m i n g a t r a c k o r a b o o k m a r k , a s h o r t r e w i n d c a n b e d o n e b e f o r e t h e p l a y b a c k

i s s t a r t e d . T h i s c a n b e u s e f u l w h e n l i s t e n i n g t o s p e e c h m a t e r i a l , t o h e l p r e m e m b e r w h a t


http://www.rockbox.org/wiki/LastFMLog

http://www.last.fm/




w a s b e i n g s a i d j u s t b e f o r e p l a y b a c k w a s s t o p p e d . T h e s i z e o f t h e r e w i n d c a n b e s e t t o

v a r i o u s v a l u e s b e t w e e n 0 ( o ) a n d 6 0 s e c o n d s .

N o t e : T h e r e w i n d i s n o t d o n e w h e n r e s u m i n g a p a u s e d t r a c k . bN o t e : T h e a c t u a l r e w i n d d i s t a n c e m a y d i e r a l i t t l e f r o m t h e r e q u e s t e d v a l u e , d e p e n d i n g

bo n t h e l e i n q u e s t i o n .




C h a p t e r 8 . G e n e r a l S e t t i n g s 6 1

8 . G e n e r a l S e t t i n g s

F i g u r e 8 . 1 . : T h e g e n e r a l s e t t i n g s s c r e e n

8 . 1 . P l a y l i s t

T h e P l a y l i s t s u b m e n u a l l o w s y o u t o c o n g u r e s e t t i n g s r e l a t e d t o p l a y l i s t s .

R e c u r s i v e l y I n s e r t D i r e c t o r i e s . I f s e t t o O n , t h e n w h e n a d i r e c t o r y i s i n s e r t e d o r q u e u e d

i n t o a d y n a m i c p l a y l i s t , a l l s u b d i r e c t o r i e s w i l l a l s o b e i n s e r t e d . I f s e t t o A s k ,

R o c k b o x w i l l p r o m p t t h e u s e r a b o u t w h e t h e r t o i n c l u d e s u b - d i r e c t o r i e s .

W a r n W h e n E r a s i n g D y n a m i c P l a y l i s t . I f s e t t o Y e s , R o c k b o x w i l l p r o v i d e a w a r n i n g

i f t h e u s e r a t t e m p t s t o t a k e a n a c t i o n t h a t w i l l c a u s e R o c k b o x t o e r a s e t h e c u r r e n t

d y n a m i c p l a y l i s t .

8 . 2 . F i l e V i e w

T h e F i l e V i e w m e n u d e a l s w i t h o p t i o n s r e l a t i n g t o h o w t h e F i l e B r o w s e r d i s p l a y s l e s .





S o r t C a s e S e n s i t i v e . I f t h i s o p t i o n i s s e t t o Y e s , a l l l e s t h a t s t a r t w i t h u p p e r c a s e

l e t t e r s w i l l b e l i s t e d r s t , f o l l o w e d b y a l l l e s t h a t b e g i n w i t h l o w e r c a s e l e t t e r s . I f

t h i s o p t i o n i s s e t t o N O , t h e n c a s e w i l l b e i g n o r e d w h e n s o r t i n g l e s .

S o r t D i r e c t o r i e s . T h i s o p t i o n c o n t r o l s h o w R o c k b o x s o r t s d i r e c t o r i e s . T h e d e f a u l t i s t o

s o r t t h e m a l p h a b e t i c a l l y . B y d a t e s o r t s t h e m w i t h t h e o l d e s t d i r e c t o r y r s t . B y

n e w e s t d a t e s o r t s t h e m w i t h t h e n e w e s t d i r e c t o r y r s t .

S o r t F i l e s . T h i s o p t i o n c o n t r o l s h o w R o c k b o x s o r t s l e s . A l l o f t h e o p t i o n s f o r S o r t

D i r e c t o r i e s a r e a v a i l a b l e i n t h i s o p t i o n . I n a d d i t i o n , t h e r e i s a B y t y p e o p t i o n

w h i c h s o r t s l e s a l p h a b e t i c a l l y b y t h e i r t y p e ( s u c h a s . m p 3 ) t h e n a l p h a b e t i c a l l y

w i t h i n e a c h t y p e .

I n t e r p r e t n u m b e r s w h e n s o r t i n g . A s w h o l e n u m b e r s e n a b l e s a s o r t i n g a l g o r i t h m w h i c h

i s s i m i l a r t o t h e d e f a u l t s o r t i n g o f , f o r e x a m p l e , W i n d o w s E x p l o r e r , M a c O S X ' s

F i n d e r o r N a u t i l u s , w i t h r e g a r d s t o n u m b e r s a t t h e b e g i n n i n g o r w i t h i n l e n a m e s .

I t c o m b i n e s c o n s e c u t i v e d i g i t s t o a n u m b e r u s e d f o r s o r t i n g , t a k i n g l e a d i n g z e r o s

i n t o a c c o u n t .

A s d i g i t s d i s a b l e s t h i s a l g o r i t h m , a n d c a u s e s e v e r y d i g i t t o b e c o m p a r e d s e p a -

r a t e l y . T h e f o l l o w i n g t a b l e d e m o n s t r a t e s t h e t w o s o r t i n g s .

A s w h o l e n u m b e r s A s d i g i t s

0 3 J a c k s o n . m p 3 0 3 J a c k s o n . m p 3

1 R i n g O f F i r e . m p 3 1 R i n g O f F i r e . m p 3

2 I W a l k T h e L i n e . m p 3 1 0 A T h i n g C a l l e d L o v e . m p 3

1 0 A T h i n g C a l l e d L o v e . m p 3 2 I W a l k T h e L i n e . m p 3

E p i s o d e 1 . o g g E p i s o d e 1 . o g g

E p i s o d e 5 7 . o g g E p i s o d e 2 3 3 . o g g

E p i s o d e 2 3 3 . o g g E p i s o d e 5 7 . o g g

S h o w F i l e s . T h i s o p t i o n c o n t r o l s w h i c h l e s a r e d i s p l a y e d i n t h e F i l e B r o w s e r .

A l l . T h e F i l e B r o w s e r d i s p l a y s a l l l e s a n d d i r e c t o r i e s . E x t e n s i o n s a r e s h o w n .

N o l e s o r d i r e c t o r i e s a r e h i d d e n .

S u p p o r t e d . T h e F i l e B r o w s e r d i s p l a y s a l l d i r e c t o r i e s a n d l e s s u p p o r t e d b y

R o c k b o x ( s e e s e c t i o n A . 1 ( p a g e 1 8 1 ) ) . F i l e s a n d d i r e c t o r i e s s t a r t i n g w i t h .

( d o t ) o r w i t h t h e h i d d e n a g s e t a r e h i d d e n .

M u s i c . T h e F i l e B r o w s e r d i s p l a y s o n l y d i r e c t o r i e s , p l a y l i s t s a n d t h e s u p p o r t e d

a u d i o l e f o r m a t s . E x t e n s i o n s a r e s t r i p p e d . F i l e s a n d d i r e c t o r i e s s t a r t i n g w i t h

. o r w i t h t h e h i d d e n a g s e t a r e h i d d e n .

P l a y l i s t s . T h e F i l e B r o w s e r d i s p l a y s o n l y d i r e c t o r i e s a n d p l a y l i s t s , f o r s i m p l i e d

n a v i g a t i o n .





S h o w F i l e n a m e E x t e n s i o n s . T h i s o p t i o n c o n t r o l s h o w l e e x t e n s i o n s a r e s h o w n i n t h e

F i l e B r o w s e r .

O . T h e l e e x t e n s i o n s a r e n e v e r s h o w n .

O n . T h e l e e x t e n s i o n s a r e a l w a y s s h o w n .

O n l y u n k n o w n t y p e s . O n l y t h e e x t e n s i o n s o f u n k n o w n l e t y p e s a r e s h o w n .

O n l y w h e n v i e w i n g a l l t y p e s . O n l y s h o w l e e x t e n s i o n s w h e n S h o w F i l e s i s s e t

t o A l l .

F o l l o w P l a y l i s t . T h i s o p t i o n d e t e r m i n e s w h a t d i r e c t o r y t h e F i l e B r o w s e r d i s p l a y s

r s t . I f F o l l o w P l a y l i s t i s s e t t o Y e s , w h e n y o u e n t e r t h e F i l e B r o w s e r

f r o m t h e W P S , y o u w i l l n d y o u r s e l f i n t h e s a m e d i r e c t o r y a s t h e c u r r e n t l y p l a y i n g

l e . I f F o l l o w P l a y l i s t i s s e t t o N o , w h e n y o u e n t e r t h e F i l e B r o w s e r f r o m

t h e W P S , y o u w i l l n d y o u r s e l f i n t h e d i r e c t o r y y o u w e r e i n w h e n y o u l a s t l e f t t h e

F i l e B r o w s e r .

S h o w P a t h . I f t h i s s e t t i n g i s s e t t o F u l l P a t h t h e f u l l p a t h t o t h e c u r r e n t d i r e c t o r y w i l l

b e d i s p l a y e d o n t h e r s t l i n e i n t h e F i l e B r o w s e r . I f s e t t o C u r r e n t D i r e c t o r y

O n l y o n l y t h e n a m e o f t h e c u r r e n t d i r e c t o r y w i l l b e d i s p l a y e d .

T h i s h a s a s i m i l a r e e c t o n t h e D a t a b a s e b r o w s e r . I f s e t t o C u r r e n t D i r e c t o r y

O n l y o r F u l l P a t h , t h e n t h e t i t l e o f e a c h m e n u w i l l b e d i s p l a y e d o n t h e r s t l i n e

i n t h e D a t a b a s e B r o w s e r .

8 . 3 . D a t a b a s e

T h i s s u b m e n u a l l o w s y o u t o c o n g u r e t h e d a t a b a s e . S e e s e c t i o n 4 . 2 ( p a g e 2 7 ) f o r m o r e

i n f o r m a t i o n a b o u t u s i n g t h e d a t a b a s e .

8 . 4 . D i s p l a y

L C D S e t t i n g s . T h i s s u b m e n u c o n t a i n s s e t t i n g s t h a t r e l a t e t o t h e d i s p l a y o f t h e p l a y e r .

B a c k l i g h t . T h e a m o u n t o f t i m e t h e b a c k l i g h t s h i n e s a f t e r a k e y p r e s s . I f s e t t o

O f f , t h e b a c k l i g h t w i l l n o t l i g h t w h e n a b u t t o n i s p r e s s e d . I f s e t t o O n , t h e

b a c k l i g h t w i l l n e v e r s h u t o . I f s e t t o a t i m e ( 1 t o 9 0 s e c o n d s ) , t h e b a c k l i g h t

w i l l s t a y l i t f o r t h a t a m o u n t o f t i m e a f t e r a b u t t o n p r e s s .

B a c k l i g h t ( W h i l e P l u g g e d I n ) . T h i s s e t t i n g i s e q u i v a l e n t t o t h e B a c k l i g h t s e t -

t i n g e x c e p t i t a p p l i e s w h e n t h e p l a y e r i s p l u g g e d i n t o t h e c h a r g e r .

B a c k l i g h t o n H o l d . T h i s s e t t i n g c o n t r o l s t h e b e h a v i o r o f t h e b a c k l i g h t w h e n t h e

H o l d s w i t c h i s t o g g l e d . I f s e t t o N o r m a l t h e b a c k l i g h t w i l l b e h a v e a s u s u a l . I f

s e t t o O f f t h e b a c k l i g h t w i l l b e t u r n e d o i m m e d i a t e l y w h e n t h e H o l d s w i t c h

i s e n g a g e d a n d i f s e t t o O n t h e b a c k l i g h t w i l l b e t u r n e d o n a n d s t a y o n w h i l e

t h e H o l d s w i t c h i s e n g a g e d .





C a p t i o n B a c k l i g h t . T h i s o p t i o n t u r n s o n t h e b a c k l i g h t a n u m b e r o f s e c o n d s b e f o r e

t h e s t a r t o f a n e w t r a c k , a n d k e e p s i t o n f o r t h e s a m e n u m b e r o f s e c o n d s a f t e r

t h e b e g i n n i n g s o t h a t t h e d i s p l a y c a n b e r e a d t o s e e s o n g i n f o r m a t i o n . T h e

a m o u n t o f t i m e i s d e t e r m i n e d b y t h e v a l u e o f t h e b a c k l i g h t t i m e o u t s e t t i n g ,

b u t i s n o l e s s t h a n 5 s e c o n d s .

F i r s t K e y p r e s s E n a b l e s B a c k l i g h t O n l y . W i t h t h i s o p t i o n e n a b l e d t h e r s t k e y -

p r e s s w h i l e t h e b a c k l i g h t i s t u r n e d o w i l l o n l y t u r n t h e b a c k l i g h t o n w i t h o u t

h a v i n g a n y o t h e r e e c t . W h e n d i s a b l e d t h e r s t k e y p r e s s w i l l a l s o p e r f o r m i t s

a p p r o p r i a t e a c t i o n .

S l e e p ( A f t e r B a c k l i g h t O ) . T h i s s e t t i n g c o n t r o l s h o w l o n g r o c k b o x w i l l w a i t b e -

f o r e t u r n i n g o t h e d i s p l a y a f t e r t h e b a c k l i g h t i s t u r n e d o . T u r n i n g o t h e

d i s p l a y s a v e s b a t t e r y p o w e r b u t t u r n i n g o n t h e d i s p l a y t a k e s n o t i c e a b l y l o n g e r

t h a n j u s t t u r n i n g o n t h e b a c k l i g h t .

B r i g h t n e s s . C h a n g e s t h e b r i g h t n e s s o f y o u r L C D d i s p l a y .

C o n t r a s t . C h a n g e s t h e c o n t r a s t o f y o u r L C D d i s p l a y .

W a r n i n g : S e t t i n g t h e c o n t r a s t t o o d a r k o r t o o l i g h t c a n m a k e i t h a r d t o n d !t h i s m e n u o p t i o n a g a i n !

U p s i d e D o w n . D i s p l a y s t h e s c r e e n s o t h a t t h e t o p o f t h e d i s p l a y i s n e a r e s t t h e

b u t t o n s . T h i s i s s o m e t i m e s u s e f u l w h e n c a r r y i n g t h e p l a y e r i n a p o c k e t f o r

e a s y a c c e s s t o t h e h e a d p h o n e s o c k e t .

S c r o l l i n g . T h i s f e a t u r e c o n t r o l s h o w t e x t w i l l s c r o l l i n R o c k b o x . Y o u c a n c o n g u r e t h e

f o l l o w i n g p a r a m e t e r s :

S c r o l l S p e e d . S e t s h o w m a n y t i m e s p e r s e c o n d t h e a u t o m a t i c h o r i z o n t a l s c r o l l i n g

t e x t w i l l m o v e a s t e p .

S c r o l l S t a r t D e l a y . C o n t r o l s h o w m a n y m i l l i s e c o n d s R o c k b o x s h o u l d w a i t b e f o r e

a n e w t e x t b e g i n s a u t o m a t i c a l l y s c r o l l i n g .

S c r o l l S t e p S i z e . D e n e s t h e n u m b e r o f p i x e l s t h e t e x t s h o u l d m o v e f o r e a c h s t e p ,

a s u s e d b y t h e S c r o l l S p e e d s e t t i n g .

B i d i r e c t i o n a l S c r o l l L i m i t . R o c k b o x h a s t w o d i e r e n t a u t o m a t i c h o r i z o n t a l s c r o l l i n g

m e t h o d s : 1 ) a l w a y s s c r o l l i n g t h e t e x t t o t h e l e f t u n t i l t h e l i n e h a s e n d e d a n d

t h e n b e g i n n i n g a g a i n a t t h e s t a r t , a n d 2 ) m o v i n g t o t h e l e f t u n t i l y o u c a n r e a d

t h e e n d o f t h e l i n e a n d t h e n s c r o l l i n g r i g h t u n t i l y o u s e e t h e b e g i n n i n g a g a i n .

R o c k b o x c h o o s e s w h i c h m e t h o d i t s h o u l d u s e d e p e n d i n g o f h o w m u c h i t h a s

t o s c r o l l t o t h e l e f t . T h i s s e t t i n g l e t s y o u t e l l R o c k b o x w h e r e t h a t l i m i t i s ,

e x p r e s s e d i n p e r c e n t a g e o f t h e l i n e l e n g t h .

S c r e e n S c r o l l s O u t o f V i e w . S c r e e n s c a n b e m a n u a l l y s c r o l l e d h o r i z o n t a l l y b y p r e s s -

i n g L o n g R i g h t / L e f t . S e t t i n g t h i s o p t i o n t o Y e s w i l l k e e p t h e l i s t e n t r i e s a t

t h e i r x e d p o s i t i o n s a n d a l l o w t h e m t o b e s c r o l l e d o u t o f v i e w , w h e r e a s N o

w i l l o n l y s c r o l l t h o s e e n t r i e s w h i c h s u r p a s s t h e r i g h t m a r g i n .





S c r e e n S c r o l l S t e p S i z e . D e n e s t h e n u m b e r o f p i x e l s t h e h o r i z o n t a l m a n u a l s c r e e n

s c r o l l s h o u l d m o v e f o r e a c h s t e p .

P a g e d S c r o l l i n g . W h e n s e t t o Y e s s c r o l l i n g v e r t i c a l l y o n p a g e s t h a t s u r p a s s t h e

s c r e e n s i z e w i l l p a g e u p / d o w n i n s t e a d o f s i m p l y c h a n g i n g l i n e s . T h i s c a n b e

u s e f u l o n s l o w d i s p l a y s .

P e a k M e t e r . T h e p e a k m e t e r c a n b e c o n g u r e d w i t h a n u m b e r o f p a r a m e t e r s .

P e a k R e l e a s e . T h i s d e t e r m i n e s h o w f a s t t h e b a r s h r i n k s w h e n t h e m u s i c b e c o m e s

s o f t e r . L o w e r v a l u e s m a k e t h e p e a k m e t e r l o o k s m o o t h e r . E x p r e s s e d i n s c a l e

u n i t s p e r 1 0 m s .

P e a k H o l d T i m e . S p e c i e s t h e t i m e a f t e r w h i c h t h e p e a k i n d i c a t o r w i l l r e s e t . F o r

e x a m p l e , i f y o u s e t t h i s v a l u e t o 5 s , t h e p e a k i n d i c a t o r d i s p l a y s t h e l o u d e s t

v o l u m e v a l u e t h a t o c c u r r e d w i t h i n t h e l a s t 5 s e c o n d s . L a r g e r v a l u e s a r e u s e f u l

i f y o u w a n t t o n d t h e p e a k l e v e l o f a s o n g , w h i c h m i g h t b e o f i n t e r e s t w h e n

c o p y i n g m u s i c f r o m t h e p l a y e r v i a t h e a n a l o g u e o u t p u t t o s o m e o t h e r r e c o r d i n g

d e v i c e .

C l i p H o l d T i m e . T h e n u m b e r o f s e c o n d s t h a t t h e c l i p p i n g i n d i c a t o r w i l l b e v i s i b l e

a f t e r c l i p p i n g i s d e t e c t e d .

S c a l e . S e l e c t w h e t h e r t h e p e a k m e t e r d i s p l a y s l i n e a r o r l o g a r i t h m i c v a l u e s . T h e

h u m a n e a r p e r c e i v e s l o u d n e s s o n a l o g a r i t h m i c s c a l e . I f t h e S c a l e s e t t i n g i s

s e t t o L o g a r i t h m i c ( d B ) s c a l e , t h e v o l u m e v a l u e s a r e s c a l e d l o g a r i t h m i c a l l y .

T h e v o l u m e m e t e r s o f d i g i t a l a u d i o d e v i c e s u s u a l l y a r e s c a l e d t h i s w a y . O n

t h e o t h e r h a n d , i f y o u a r e i n t e r e s t e d i n t h e p o w e r l e v e l t h a t i s a p p l i e d t o

y o u r h e a d p h o n e s y o u s h o u l d c h o o s e L i n e a r d i s p l a y . T h i s s e t t i n g c a n n o t

b e d i s p l a y e d i n u n i t s l i k e v o l t s o r w a t t s b e c a u s e s u c h u n i t s d e p e n d o n y o u r

h e a d p h o n e s .

M i n i m u m a n d m a x i m u m r a n g e . T h e s e t w o o p t i o n s d e n e t h e f u l l v a l u e r a n g e t h a t

t h e p e a k m e t e r d i s p l a y s . R e c o m m e n d e d v a l u e s f o r t h e L o g a r i t h m i c ( d B )

s e t t i n g a r e - 4 0 d B f o r m i n i m u m a n d 0 d B f o r m a x i m u m . R e c o m m e n d e d v a l u e s

f o r L i n e a r d i s p l a y a r e 0 a n d 1 0 0 % . N o t e t h a t - 4 0 d B i s a p p r o x i m a t e l y 1 %

i n l i n e a r v a l u e , b u t i f y o u c h a n g e t h e m i n i m u m s e t t i n g i n l i n e a r m o d e s l i g h t l y

a n d t h e n c h a n g e t o t h e d B s c a l e , t h e r e w i l l b e a l a r g e c h a n g e . Y o u c a n u s e

t h e s e v a l u e s f o r ` z o o m i n g ' i n t o t h e p e a k m e t e r .

D e f a u l t C o d e p a g e . A c o d e p a g e d e s c r i b e s t h e w a y e x t e n d e d c h a r a c t e r s t h a t a r e n o t a v a i l -

a b l e w i t h i n t h e A S C I I c h a r a c t e r s e t a r e e n c o d e d . I D 3 v 1 t a g s d o n o t h a v e a c o d e p a g e

e n c o d i n g c o n t a i n e d s o R o c k b o x n e e d s t o k n o w w h a t e n c o d i n g h a s b e e n u s e d w h e n

g e n e r a t i n g t h e s e t a g s . T h i s s h o u l d b e I S O - 8 8 5 9 - 1 b u t t o s u p p o r t l a n g u a g e s o u t -

s i d e W e s t e r n E u r o p e m o s t a p p l i c a t i o n s u s e t h e s e t t i n g o f y o u r o p e r a t i n g s y s t e m

i n s t e a d . I f y o u r o p e r a t i n g s y s t e m u s e s a d i e r e n t c o d e p a g e a n d y o u a r e g e t t i n g

g a r b l e d e x t e n d e d c h a r a c t e r s y o u s h o u l d a d j u s t t h i s s e t t i n g s . I n m o s t c a s e s s t i c k i n g

t o I S O - 8 8 5 9 - 1 w o u l d b e s u c i e n t .





8 . 5 . S y s t e m

8 . 5 . 1 . S t a r t S c r e e n

S e t t h e s c r e e n t h a t R o c k b o x w i l l s t a r t i n . T h e d e f a u l t i s t h e m a i n m e n u b u t t h e f o l l o w i n g

o p t i o n s a r e a v a i l a b l e :

P r e v i o u s S c r e e n . S t a r t R o c k b o x i n t h e s a m e s c r e e n a s w h e n i t w a s s h u t o .

M a i n M e n u . S h o w t h e m a i n m e n u .

F i l e s . D i s p l a y t h e l e b r o w s e r , s t a r t i n g i n t h e r o o t d i r e c t o r y o f y o u r p l a y e r .

D a t a b a s e . S h o w t h e d e f a u l t d a t a b a s e v i e w .

R e s u m e P l a y b a c k . G o t o t h e W P S a n d a n d r e s u m e p l a y b a c k f r o m w h e r e i t w a s b e f o r e

t u r n i n g o ( i f t h e r e i s a p l a y l i s t t o r e s u m e ) .

S e t t i n g s . D i s p l a y t h e m a i n s e t t i n g s m e n u .

R e c e n t B o o k m a r k s . S h o w t h e l i s t o f r e c e n t b o o k m a r k s a s d e s c r i b e d i n s e c t i o n 8 . 6 ( p a g e 6 8 ) .

B o o k m a r k i n g n e e d s t o b e e n a b l e d .

8 . 5 . 2 . B a t t e r y

O p t i o n s r e l a t i n g t o t h e b a t t e r y i n t h e p l a y e r .

B a t t e r y C a p a c i t y . T h i s s e t t i n g c a n b e u s e d t o t e l l R o c k b o x w h a t c a p a c i t y ( i n m A h ) t h e

b a t t e r y b e i n g u s e d h a s . T h e d e f a u l t i s 2 0 0 0 m A h , w h i c h i s t h e c a p a c i t y v a l u e f o r

t h e s t a n d a r d b a t t e r y s h i p p e d w i t h t h e p l a y e r . R o c k b o x u s e s t h i s v a l u e f o r r u n t i m e

e s t i m a t i o n , n o t b a t t e r y p e r c e n t a g e c a l c u l a t i o n . C h a n g i n g t h i s s e t t i n g h a s n o e e c t

w h a t s o e v e r o n a c t u a l b a t t e r y l i f e . T h i s s e t t i n g o n l y a e c t s t h e a c c u r a c y o f t h e

r u n t i m e e s t i m a t i o n a s s h o w n o n s c r e e n .

8 . 5 . 3 . D i s k

O p t i o n s r e l a t i n g t o t h e h a r d d i s k .

D i s k S p i n d o w n . R o c k b o x h a s a t i m e r t h a t m a k e s i t s p i n d o w n t h e h a r d d i s k a f t e r i t i s

i d l e f o r a c e r t a i n a m o u n t o f t i m e . T h i s s e t t i n g c o n t r o l s t h e a m o u n t o f t i m e b e t w e e n

t h e l a s t u s e r a c t i v i t y a n d t h e t i m e t h a t t h e d i s k s p i n s d o w n . T h i s i d l e t i m e i s o n l y

a e c t e d b y u s e r a c t i v i t y , l i k e n a v i g a t i n g t h r o u g h t h e F i l e B r o w s e r . W h e n t h e

h a r d d i s k s p i n s u p t o l l t h e a u d i o b u e r , i t a u t o m a t i c a l l y s p i n s d o w n a f t e r w a r d s .

D i r e c t o r y C a c h e . R o c k b o x h a s t h e a b i l i t y t o c a c h e t h e c o n t e n t s o f y o u r d r i v e i n R A M .

T h e D i r e c t o r y C a c h e t a k e s a s m a l l a m o u n t o f m e m o r y a w a y f r o m R o c k b o x

t h a t w o u l d o t h e r w i s e b e u s e d t o b u e r m u s i c , b u t i t s p e e d s u p n a v i g a t i o n i n t h e

l e b r o w s e r b y e l i m i n a t i n g t h e s l i g h t p a u s e b e t w e e n t h e t i m e a n a v i g a t i o n b u t t o n





i s p r e s s e d a n d t h e t i m e R o c k b o x r e s p o n d s . T u r n i n g t h i s s e t t i n g o n a c t i v a t e s t h e

d i r e c t o r y c a c h e , a n d t u r n i n g i t o d e a c t i v a t e s t h e d i r e c t o r y c a c h e .

N o t e : T h e r s t t i m e y o u e n a b l e t h e d i r e c t o r y c a c h e , R o c k b o x w i l l r e q u e s t a r e b o o t bo f t h e p l a y e r a n d u p o n r e s t a r t i n g t a k e a f e w m i n u t e s t o s c a n t h e d r i v e . A f t e r t h i s ,

t h e d i r e c t o r y c a c h e w i l l w o r k i n t h e b a c k g r o u n d .

8 . 5 . 4 . I d l e P o w e r o

R o c k b o x c a n b e c o n g u r e d t o t u r n o p o w e r a f t e r t h e u n i t h a s b e e n i d l e f o r a d e n e d

n u m b e r o f m i n u t e s . T h e p l a y e r i s i d l e w h e n p l a y b a c k i s s t o p p e d o r p a u s e d . I t i s n o t i d l e

w h i l e t h e U S B o r c h a r g e r i s c o n n e c t e d . S e t t i n g s a r e e i t h e r O f f o r 1 t o 1 0 m i n u t e s i n 1

m i n u t e s t e p s . T h e n 1 5 , 3 0 , 4 5 o r 6 0 m i n u t e s a r e a v a i l a b l e .

8 . 5 . 5 . L i m i t s

T h i s s u b m e n u r e l a t e s t o l i m i t s i n t h e R o c k b o x o p e r a t i n g s y s t e m .

M a x E n t r i e s i n F i l e B r o w s e r . T h i s s e t t i n g c o n t r o l s t h e l i m i t o n t h e n u m b e r o f l e s t h a t

y o u c a n p u t i n a n y p a r t i c u l a r d i r e c t o r y i n t h e l e b r o w s e r . Y o u c a n c o n g u r e t h e

s i z e t o b e b e t w e e n 5 0 a n d 1 0 , 0 0 0 l e s i n s t e p s o f 5 0 . T h e d e f a u l t i s 4 0 0 . H i g h e r

v a l u e s w i l l s h o r t e n t h e m u s i c b u e r , s o y o u s h o u l d i n c r e a s e t h i s s e t t i n g o n l y i f y o u

h a v e d i r e c t o r i e s w i t h a l a r g e n u m b e r o f l e s .

M a x P l a y l i s t S i z e . T h i s s e t t i n g c o n t r o l s t h e m a x i m u m s i z e o f a p l a y l i s t . T h e p l a y l i s t

s i z e c a n b e b e t w e e n 1 , 0 0 0 a n d 3 2 , 0 0 0 l e s , i n s t e p s o f 1 , 0 0 0 ( d e f a u l t i s 1 0 , 0 0 0 ) .

H i g h e r v a l u e s w i l l s h o r t e n t h e m u s i c b u e r , s o y o u s h o u l d i n c r e a s e t h i s s e t t i n g o n l y

i f y o u h a v e v e r y l a r g e p l a y l i s t s .

8 . 5 . 6 . C a r A d a p t e r M o d e

T h i s o p t i o n t u r n s O n a n d O f f t h e c a r i g n i t i o n a u t o s t o p f u n c t i o n .

C a r A d a p t e r M o d e . W h e n u s i n g t h e p l a y e r i n a c a r , C a r A d a p t e r M o d e a u t o m a t -

i c a l l y s t o p s p l a y b a c k o n t h e p l a y e r w h e n p o w e r ( i . e . f r o m c i g a r e t t e l i g h t e r p o w e r

a d a p t e r ) t o t h e e x t e r n a l D C i n j a c k i s t u r n e d o . I f t h e C a r A d a p t e r M o d e i s

s e t t o O n , R o c k b o x w i l l p a u s e p l a y b a c k w h e n t h e e x t e r n a l p o w e r o c o n d i t i o n i s

d e t e c t e d . R o c k b o x w i l l t h e n s h u t d o w n t h e p l a y e r a f t e r t h e l e n g t h o f t i m e s e t i n t h e

I d l e P o w e r o f f s e t t i n g ( s e e a b o v e ) . I f p o w e r t o t h e D C i n j a c k i s t u r n e d b a c k o n

b e f o r e t h e I d l e P o w e r o f u n c t i o n h a s s h u t t h e p l a y e r o , p l a y b a c k w i l l b e r e s u m e d

5 s e c o n d s a f t e r t h e p o w e r i s a p p l i e d . T h i s d e l a y i s t o a l l o w f o r t h e t i m e w h i l e t h e

c a r e n g i n e i s b e i n g s t a r t e d .

O n c e t h e p l a y e r i s s h u t o e i t h e r m a n u a l l y , o r a u t o m a t i c a l l y w i t h t h e I d l e P o w e r o f f

f u n c t i o n , i t m u s t b e p o w e r e d u p m a n u a l l y t o r e s u m e p l a y b a c k .





8 . 5 . 7 . B u t t o n L i g h t T i m e o u t

T h i s s e t t i n g c o n t r o l s t h e a m o u n t o f t i m e t h e b u t t o n l i g h t s s h i n e a f t e r a b u t t o n p r e s s . I f

s e t t o O f f , t h e L E D s w i l l n o t l i g h t w h e n a b u t t o n i s p r e s s e d . I f s e t t o O n , t h e l i g h t s

w i l l n e v e r s h u t o . I f s e t t o a t i m e ( 1 t o 1 2 0 s e c o n d s ) , t h e b u t t o n s w i l l s t a y l i t f o r t h a t

a m o u n t o f t i m e a f t e r a b u t t o n p r e s s .

8 . 5 . 8 . B u t t o n L i g h t B r i g h t n e s s

C h a n g e s t h e b r i g h t n e s s o f t h e b u t t o n l i g h t s .

8 . 6 . B o o k m a r k i n g

B o o k m a r k s a l l o w y o u t o s a v e y o u r c u r r e n t p o s i t i o n w i t h i n a t r a c k s o t h a t y o u c a n r e t u r n

t o i t a t a l a t e r t i m e . B o o k m a r k s a l s o s t o r e r a t e , p i t c h a n d s p e e d i n f o r m a t i o n f r o m t h e

P i t c h S c r e e n ( s e e s e c t i o n 4 . 3 . 3 ( p a g e 3 4 ) ) . B o o k m a r k s a r e s a v e d o n a p e r d i r e c t o r y

b a s i s o r f o r i n d i v i d u a l ( s a v e d ) p l a y l i s t s . Y o u c a n s t o r e m u l t i p l e b o o k m a r k s , e v e n f o r t h e

s a m e t r a c k . W h e n t h e r e ' s a l r e a d y a b o o k m a r k f o r a d i r e c t o r y o r p l a y l i s t , n e w b o o k m a r k s

a r e a d d e d b e f o r e e x i s t i n g o n e s .

B o o k m a r k s a r e s t o r e d n e x t t o t h e d i r e c t o r y o r p l a y l i s t t h e y r e f e r e n c e , i n a l e w i t h t h e

s a m e n a m e a s t h e d i r e c t o r y o r p l a y l i s t a n d a . b m a r k e x t e n s i o n . T o l o a d a b o o k m a r k ,

s e l e c t t h e b o o k m a r k l e a n d t h e n s e l e c t t h e b o o k m a r k t o l o a d . T h e r e a r e o t h e r w a y s t o

l o a d a b o o k m a r k s m e n t i o n e d b e l o w .

N o t e : B o o k m a r k i n g o n l y w o r k s w h e n t r a c k s a r e l a u n c h e d f r o m t h e l e b r o w s e r , a n d bd o e s n o t w o r k f o r t r a c k s l a u n c h e d v i a t h e d a t a b a s e . I n a d d i t i o n , t h e y d o n o t w o r k w i t h

d y n a m i c p l a y l i s t s .

B o o k m a r k o n S t o p . T h i s o p t i o n c o n t r o l s w h e t h e r R o c k b o x c r e a t e s a b o o k m a r k w h e n

p l a y b a c k i s s t o p p e d m a n u a l l y .

N o . D o n o t c r e a t e b o o k m a r k s .

Y e s . A l w a y s c r e a t e b o o k m a r k s .

A s k . A s k i f a b o o k m a r k s h o u l d b e c r e a t e d .

Y e s R e c e n t O n l y . A l w a y s c r e a t e a b o o k m a r k , b u t o n l y i n t h e r e c e n t b o o k m a r k s

l i s t .

A s k R e c e n t O n l y . A s k i f a b o o k m a r k s h o u l d b e c r e a t e d , b u t o n l y a d d i t t o t h e

r e c e n t b o o k m a r k s l i s t .

W h e n e i t h e r Y e s R e c e n t O n l y o r A s k R e c e n t O n l y i s s e l e c t e d , b o o k m a r k s

a r e o n l y c r e a t e d i f t h e M a i n t a i n a L i s t o f R e c e n t B o o k m a r k s i s e n a b l e d .

N o t e : T h e R e s u m e f u n c t i o n r e m e m b e r s y o u r p o s i t i o n i n t h e m o s t r e c e n t l y a c c e s s e d bt r a c k r e g a r d l e s s o f h o w t h e B o o k m a r k o n S t o p o p t i o n i s s e t .





U p d a t e o n S t o p . I f s e t t o N o , t h i s s e t t i n g h a s n o e e c t a n d d o e s n o t a e c t a n y o t h e r

s e t t i n g s . I f s e t t o Y e s , a n d t h e l e t o w h i c h a n e w b o o k m a r k w o u l d b e a d d e d

a l r e a d y e x i s t s , t h i s o p t i o n o v e r r i d e s t h e p r e v i o u s s e t t i n g ( B o o k m a r k o n S t o p )

a n d u n c o n d i t i o n a l l y c r e a t e s a b o o k m a r k . T h i s i s u s e f u l i f y o u d o n ' t g e n e r a l l y w a n t

t o c r e a t e b o o k m a r k s b u t o n l y w a n t t o a d d t h e m t o a l r e a d y e x i s t i n g b o o k m a r k

l e s . I n t h i s c a s e y o u s h o u l d s e t t h e s e t t i n g B o o k m a r k o n S t o p t o N o a n d t h e

s e t t i n g U p d a t e o n S t o p t o Y e s .

L o a d L a s t B o o k m a r k . T h i s o p t i o n c o n t r o l s i f R o c k b o x s h o u l d a u t o m a t i c a l l y l o a d a

b o o k m a r k f o r a l e , w h e n t h a t l e i s p l a y e d .

N o A l w a y s s t a r t f r o m t h e b e g i n n i n g o f t h e t r a c k o r p l a y l i s t .

Y e s A u t o m a t i c a l l y r e t u r n t o t h e p o s i t i o n o f t h e l a s t b o o k m a r k . S t a r t f r o m t h e

b e g i n n i n g i f t h e r e a r e n o b o o k m a r k s .

A s k A s k i f p l a y b a c k s h o u l d s t a r t f r o m t h e b e g i n n i n g o f t h e t r a c k o r f r o m o n e o f

t h e b o o k m a r k s .

M a i n t a i n a l i s t o f R e c e n t B o o k m a r k s . I f t h i s o p t i o n i s e n a b l e d , a l i s t o f t h e m o s t r e -

c e n t l y c r e a t e d b o o k m a r k s m a y b e a c c e s s e d t h r o u g h t h e R e c e n t B o o k m a r k s

o p t i o n i n t h e M a i n M e n u . T h i s l i s t c o n t a i n s u p t o t e n e n t r i e s .

N o D o n o t k e e p a l i s t o f r e c e n t l y u s e d b o o k m a r k s . T h i s a l s o r e m o v e s t h e R e c e n t

B o o k m a r k s f r o m t h e M a i n M e n u .

Y e s K e e p a l i s t o f r e c e n t l y u s e d b o o k m a r k s . E a c h n e w b o o k m a r k i s a d d e d t o t h e

l i s t o f r e c e n t b o o k m a r k s .

U n i q u e O n l y A d d e a c h n e w b o o k m a r k t o t h e l i s t o f r e c e n t l y u s e d b o o k m a r k s , b u t

o n l y k e e p o n e b o o k m a r k f r o m t h e c u r r e n t d i r e c t o r y o r p l a y l i s t ; a n y p r e v i o u s

e n t r i e s a r e r e m o v e d .

T h e f o l l o w i n g k e y s c a n b e u s e d t o n a v i g a t e i n a n y b o o k m a r k l i s t .


D o w n V o l u m e D o w n S e l e c t s t h e n e x t b o o k m a r k .

U p V o l u m e U p S e l e c t s t h e p r e v i o u s b o o k m a r k .

S e l e c t o r R i g h t F o r w a r d R e s u m e s f r o m t h e s e l e c t e d b o o k m a r k .

L e f t o r P o w e r R e w i n d E x i t s R e c e n t B o o k m a r k m e n u

A L o n g M e n u D e l e t e s t h e c u r r e n t l y s e l e c t e d b o o k m a r k

L o n g S e l e c t L o n g M e n u E n t e r s t h e c o n t e x t m e n u f o r t h e s e l e c t e d

b o o k m a r k .

T h e r e a r e t w o o p t i o n s i n t h e c o n t e x t m e n u :

• R e s u m e w i l l c o m m e n c e p l a y b a c k o f t h e c u r r e n t l y s e l e c t e d b o o k m a r k e n t r y .

• D e l e t e w i l l r e m o v e t h e c u r r e n t l y s e l e c t e d b o o k m a r k e n t r y f r o m t h e l i s t .





8 . 7 . L a n g u a g e

T h i s s e t t i n g c o n t r o l s t h e l a n g u a g e o f t h e R o c k b o x u s e r i n t e r f a c e . S e l e c t i n g a l a n g u a g e

w i l l a c t i v a t e i t . T h e l a n g u a g e l e s m u s t b e i n t h e / . r o c k b o x / l a n g s / d i r e c t o r y . S e e

s e c t i o n 1 1 . 1 . 3 ( p a g e 1 6 7 ) f o r f u r t h e r d e t a i l s a b o u t l a n g u a g e s .

8 . 8 . V o i c e

V o i c e M e n u s . T h i s o p t i o n c o n t r o l s t h e v o i c i n g o f m e n u s / s e t t i n g s a s t h e y a r e s e l e c t e d

b y t h e c u r s o r . I n o r d e r f o r t h i s t o w o r k , a v o i c e l e m u s t b e p r e s e n t i n t h e

/ . r o c k b o x / l a n g s / d i r e c t o r y o n t h e p l a y e r . V o i c e l e s a r e l a r g e a n d a r e n o t s h i p p e d

w i t h R o c k b o x b y d e f a u l t . T h e v o i c e l e i s t h e n a m e o f t h e l a n g u a g e f o r w h i c h i t

i s m a d e , f o l l o w e d b y t h e e x t e n s i o n . v o i c e . S o f o r E n g l i s h , t h e l e n a m e w o u l d

b e e n g l i s h . v o i c e . T h i s o p t i o n i s o n b y d e f a u l t , b u t w i l l d o n o t h i n g u n l e s s t h e

a p p r o p r i a t e v o i c e l e i s i n s t a l l e d i n t h e c o r r e c t p l a c e o n t h e p l a y e r . T h e V o i c e

M e n u s h a v e s e v e r a l l i m i t a t i o n s :

• S e t t i n g t h e S o u n d O p t i o n C h a n n e l s t o K a r a o k e m a y d i s a b l e v o i c e m e n u s .

• P l u g i n s a n d t h e w a k e u p a l a r m d o n o t s u p p o r t v o i c e f e a t u r e s .

V o i c e D i r e c t o r i e s . T h i s o p t i o n c o n t r o l s v o i c i n g o f d i r e c t o r y n a m e s . A v o i c e l e m u s t b e

p r e s e n t f o r t h i s t o w o r k . S e v e r a l o p t i o n s a r e a v a i l a b l e .

S p e l l . S p e a k t h e d i r e c t o r y n a m e b y s p e l l i n g i t o u t l e t t e r b y l e t t e r . S u p p o r t i s

p r o v i d e d o n l y f o r t h e m o s t c o m m o n l e t t e r s , n u m b e r s a n d p u n c t u a t i o n .

N u m b e r s . E a c h d i r e c t o r y i s a s s i g n e d a n u m b e r b a s e d u p o n i t s p o s i t i o n i n t h e l e

l i s t . T h e y a r e t h e n a n n o u n c e d a s D i r e c t o r y 1 , D i r e c t o r y 2 e t c .

O . N o a t t e m p t w i l l b e m a d e t o s p e a k d i r e c t o r y n a m e s .

Y o u c a n u s e p r e - g e n e r a t e d . t a l k c l i p s t o h a v e d i r e c t o r y n a m e s s p o k e n p r o p e r l y , b u t

y o u m u s t e n a b l e t h i s e x p l i c i t l y ( s e e b e l o w ) .

U s e D i r e c t o r y . t a l k C l i p s . T h i s o p t i o n t u r n s o n t h e u s e o f . t a l k c l i p s f o r d i r e c t o r i e s .

O n . U s e s p e c i a l p r e - r e c o r d e d l e s ( _ d i r n a m e . t a l k ) i n e a c h d i r e c t o r y . T h e s e m u s t

b e g e n e r a t e d i n a d v a n c e , a n d a r e t y p i c a l l y p r o d u c e d s y n t h e t i c a l l y u s i n g a

t e x t - t o - s p e e c h e n g i n e o n a P C .

O . N o c h e c k i n g i s m a d e f o r d i r e c t o r y . t a l k c l i p s ; t h e y a r e n o t u s e d e v e n i f p r e s e n t .

T h i s c a n r e d u c e d i s k a c t i v i t y .

U s e o f a . t a l k c l i p t a k e s p r e c e d e n c e o v e r o t h e r d i r e c t o r y n a m e v o i c i n g . O t h e r w i s e

( e . g . i f a . t a l k c l i p i s n o t a v a i l a b l e ) , v o i c i n g u s e s t h e m e t h o d s e t u n d e r V o i c e

D i r e c t o r i e s a b o v e .

V o i c e F i l e n a m e s . T h i s o p t i o n c o n t r o l s v o i c i n g o f l e n a m e s . A g a i n , a v o i c e l e m u s t b e

p r e s e n t f o r t h i s t o w o r k . T h e o p t i o n s p r o v i d e d a r e S p e l l , N u m b e r s , a n d O f f

w h i c h f u n c t i o n t h e s a m e a s f o r V o i c e D i r e c t o r i e s . Y o u c a n u s e p r e - g e n e r a t e d





. t a l k c l i p s t o h a v e l e n a m e s s p o k e n p r o p e r l y , b u t y o u m u s t e n a b l e t h i s e x p l i c i t l y

( s e e b e l o w ) .

U s e F i l e . t a l k C l i p s . T h i s o p t i o n t u r n s o n t h e u s e o f . t a l k c l i p s f o r l e s .

O n . U s e s p e c i a l p r e - r e c o r d e d l e s f o r e a c h l e . T h i s f u n c t i o n s t h e s a m e a s f o r

d i r e c t o r i e s e x c e p t t h a t t h e . t a l k c l i p l e m u s t h a v e t h e s a m e n a m e a s t h e

d e s c r i b e d l e w i t h a n e x t r a . t a l k e x t e n s i o n ( e . g . P u n k a d i d d l e . m p 3 w o u l d

r e q u i r e a l e c a l l e d P u n k a d i d d l e . m p 3 . t a l k ) .

O . N o c h e c k i n g i s m a d e f o r l e . t a l k c l i p s ; t h e y a r e n o t u s e d e v e n i f p r e s e n t . T h i s

c a n r e d u c e d i s k a c t i v i t y .

U s e o f a . t a l k c l i p t a k e s p r e c e d e n c e o v e r o t h e r l e n a m e v o i c i n g . O t h e r w i s e ( e . g . i f

a . t a l k c l i p i s n o t a v a i l a b l e ) , v o i c i n g u s e s t h e m e t h o d s e t u n d e r V o i c e F i l e n a m e s

a b o v e .

S a y F i l e T y p e . T h i s o p t i o n t u r n s o n v o i c i n g o f l e t y p e s w h e n V o i c e F i l e n a m e s i s s e t

t o S p e l l o r N u m b e r s . W h e n V o i c e D i r e c t o r i e s i s s e t t o S p e l l , D i r e c t o r y

w i l l b e v o i c e d a f t e r e a c h s p e l l e d o u t d i r e c t o r y .

A n n o u n c e B a t t e r y L e v e l . W h e n t h i s o p t i o n i s e n a b l e d t h e b a t t e r y l e v e l i s a n n o u n c e d

w h e n i t f a l l s u n d e r 5 0 % , 3 0 % a n d 1 5 % .

S e e ZV o i c e H o w t o f o r m o r e d e t a i l s o n c o n g u r i n g s p e e c h s u p p o r t i n R o c k b o x .

8 . 9 . H o t k e y

W P S H o t k e y .

F i l e B r o w s e r H o t k e y .

T h e s e o p t i o n s s e t t h e h o t k e y f u n c t i o n f o r t h e i r r e s p e c t i v e s c r e e n s ( s e e s e c t i o n 4 . 5

( p a g e 4 0 ) ) . T h e d e f a u l t f o r t h e W P S i s V i e w P l a y l i s t . T h e F i l e B r o w s e r d e f a u l t i s

O f f .


http://www.rockbox.org/wiki/VoiceHowto



C h a p t e r 9 . T h e m e S e t t i n g s 7 2

9 . T h e m e S e t t i n g s

T h e T h e m e S e t t i n g s m e n u o e r s o p t i o n s t h a t y o u c a n c h a n g e t o c u s t o m i z e t h e v i s u a l

a p p e r a n c e o f R o c k b o x .

B r o w s e T h e m e F i l e s . T h i s o p t i o n w i l l d i s p l a y a l l t h e c u r r e n t l y i n s t a l l e d t h e m e s o n t h e

p l a y e r , p r e s s S e l e c t o r R i g h t t o l o a d t h e c h o s e n t h e m e a n d a p p l y i t .

A t h e m e i s a c o n g u r a t i o n l e , s t o r e d i n a s p e c i c d i r e c t o r y , t h a t t y p i c a l l y c h a n g e s

t h e W P S , f o n t u s e d a n d o n s o m e p l a t f o r m s a d d i t i o n a l i n f o r m a t i o n s u c h a s b a c k -

g r o u n d i m a g e a n d t e x t c o l o u r s .

T h e r e a r e a n u m b e r o f t h e m e s t h a t s h i p w i t h R o c k b o x . I f n o n e o f t h e s e s u i t y o u r

n e e d s , m a n y m o r e c a n b e d o w n l o a d e d f r o m h t t p : / / t h e m e s . r o c k b o x . o r g / i n d e x . p h p ?

t a r g e t = g i g a b e a t f .

N o t e : T h e m e s d o n o t h a v e t o b e p u r e l y v i s u a l . I t i s q u i t e p o s s i b l e t o c r e a t e a t h e m e bt h a t s w i t c h e s b e t w e e n a u d i o c o n g u r a t i o n s f o r u s e i n t h e c a r , w i t h h e a d p h o n e s a n d

w h e n c o n n e c t e d t o a n e x t e r n a l a m p l i e r . S e e s e c t i o n 1 1 . 2 . 2 ( p a g e 1 7 0 ) f o r m o r e

d e t a i l s .

F o n t . B r o w s e t h e i n s t a l l e d f o n t s o n y o u r p l a y e r . S e l e c t i n g o n e w i l l a c t i v a t e i t . S e e

s e c t i o n 1 1 . 1 . 2 ( p a g e 1 6 7 ) f o r f u r t h e r d e t a i l s a b o u t f o n t s .

W h i l e P l a y i n g S c r e e n . O p e n s t h e F i l e B r o w s e r i n t h e / . r o c k b o x / w p s d i r e c t o r y a n d

d i s p l a y s a l l . w p s l e s . S e l e c t i n g o n e w i l l a c t i v a t e i t , L e f t o r P o w e r w i l l e x i t b a c k

t o t h e m e n u . F o r f u r t h e r i n f o r m a t i o n a b o u t t h e W P S s e e s e c t i o n 4 . 3 ( p a g e 3 0 ) .

F o r i n f o r m a t i o n a b o u t e d i t i n g a . w p s l e s e e s e c t i o n 1 1 . 2 ( p a g e 1 7 0 ) .

S h o w I c o n s . R o c k b o x h a s t h e a b i l i t y t o d i s p l a y a n i c o n t o t h e l e f t o f t h e l e i n t h e F i l e

B r o w s e r . F o r d e t a i l s o f t h e s e i c o n s , s e e s e c t i o n A . 1 ( p a g e 1 8 1 ) . T h e s e i c o n s c a n

a l s o b e c u s t o m i s e d . S e e t h e ZI c o n S e t s a n d ZC u s t o m I c o n s W i k i p a g e s f o r d e t a i l s .

C l e a r B a c k d r o p . R o c k b o x a l l o w s y o u t o s e l e c t b i t m a p p i c t u r e s t o u s e a s b a c k d r o p s , s e e

s e c t i o n 1 1 . 1 . 5 ( p a g e 1 6 9 ) f o r f u r t h e r i n f o r m a t i o n . T h i s o p t i o n a l l o w s y o u t o c l e a r

t h e b a c k d r o p s t h a t y o u s e t .

S t a t u s / S c r o l l b a r . S e t t i n g s r e l a t e d t o o n s c r e e n s t a t u s d i s p l a y a n d t h e s c r o l l b a r .

S c r o l l B a r . A l l o w s y o u t o c h o o s e w h e r e t h e v e r t i c a l s c r o l l b a r s h o u l d a p p e a r .

S c r o l l B a r W i d t h . A l l o w s y o u t o c h o o s e t h e w i d t h o f t h e s c r o l l b a r ( i n p i x e l s ) .

D e f a u l t v a l u e i s 6 .


http://www.rockbox.org/wiki/CustomIcons

http://www.rockbox.org/wiki/IconSets

http://themes.rockbox.org/index.php?target=gigabeatf

http://themes.rockbox.org/index.php?target=gigabeatf



C h a p t e r 9 . T h e m e S e t t i n g s 7 3

S t a t u s B a r . A l l o w s y o u t o c h o o s e w h e r e t o d i s p l a y t h e s t a t u s b a r .

V o l u m e D i s p l a y . C o n t r o l s w h e t h e r t h e v o l u m e i s d i s p l a y e d a s a g r a p h i c o r a n u -

m e r i c v a l u e o n t h e S t a t u s B a r . I f y o u s e l e c t a n u m e r i c d i s p l a y , v o l u m e i s

d i s p l a y e d i n d e c i b e l s . S e e s e c t i o n 6 . 1 ( p a g e 4 7 ) f o r m o r e o n t h e v o l u m e s e t -

t i n g .

B a t t e r y D i s p l a y . C o n t r o l s w h e t h e r t h e b a t t e r y c h a r g e s t a t u s i s d i s p l a y e d a s a

g r a p h i c o r n u m e r i c a l p e r c e n t a g e v a l u e o n t h e S t a t u s B a r .

L i n e S e l e c t o r T y p e . T h i s o p t i o n a l l o w s y o u t o s e l e c t w h i c h t y p e o f l i n e s e l e c t o r t o u s e .

P o i n t e r . A s m a l l a r r o w t o t h e l e f t o f t h e m e n u t e x t .

B a r ( i n v e r s e ) . A b a r w i t h i n v e r t e d f o r e g r o u n d a n d b a c k g r o u n d c o l o u r .

B a r ( S o l i d C o l o u r ) . A b a r w i t h a s o l i d c o l o u r , t h e c o l o u r i s s e t i n t h e C o l o u r s

s u b m e n u .

B a r ( G r a d i e n t C o l o u r ) . A b a r w i t h a c o l o u r g r a d i e n t , t h e c o l o u r s a r e s e t i n t h e

C o l o u r s s u b m e n u .

C o l o u r s . T h e o p t i o n s i n t h i s m e n u s e t s t h e c o l o u r s f o r v i s u a l e l e m e n t s i n R o c k b o x .

L i n e S e l e c t o r C o l o u r s . T h e s e o p t i o n s s e t s t h e c o l o u r s f o r t h e l i n e s e l e c t o r b a r s .

P r i m a r y C o l o u r . S e t t h e p r i m a r y c o l o u r u s e d f o r t h e g r a d i e n t l i n e s e l e c t o r

b a r a n d t h e c o l o u r u s e d f o r t h e s o l i d c o l o r l i n e s e l e c t o r b a r .

S e c o n d a r y C o l o u r . S e t t h e s e c o n d a r y c o l o u r u s e d f o r t h e g r a d i e n t l i n e s e l e c t o r

b a r .

T e x t C o l o u r . S e t t h e c o l o u r o f t h e s e l e c t e d t e x t w h e n u s i n g t h e s o l i d c o l o u r

o r t h e g r a d i e n t c o l o u r l i n e s e l e c t i o n b a r s .

B a c k g r o u n d C o l o u r . S e t s t h e b a c k g r o u n d c o l o u r f o r t h e d i s p l a y .

F o r e g r o u n d C o l o u r . S e t s t h e c o l o u r u s e d f o r t e x t a n d i c o n s .

R e s e t C o l o u r s . R e s e t s t h e L C D d i s p l a y t o R o c k b o x ' s d e f a u l t c o l o u r s .




C h a p t e r 1 0 . P l u g i n s 7 4

1 0 . P l u g i n s

P l u g i n s a r e p r o g r a m s t h a t R o c k b o x c a n l o a d a n d r u n . O n l y o n e p l u g i n c a n b e l o a d e d a t

a t i m e . P l u g i n s h a v e e x c l u s i v e c o n t r o l o v e r t h e u s e r i n t e r f a c e . T h i s m e a n s y o u c a n n o t

s w i t c h b a c k a n d f o r t h b e t w e e n a p l u g i n a n d R o c k b o x . W h e n a p l u g i n i s l o a d e d , y o u n e e d

t o e x i t i t t o r e t u r n t o t h e R o c k b o x i n t e r f a c e . M o s t p l u g i n s w i l l n o t i n t e r f e r e w i t h m u s i c

p l a y b a c k b u t s o m e o f t h e m w i l l s t o p p l a y b a c k w h i l e r u n n i n g . P l u g i n s h a v e t h e l e e x -

t e n s i o n . r o c k . M o s t o f t h e m c a n b e s t a r t e d f r o m B r o w s e P l u g i n s i n t h e M a i n M e n u .

V i e w e r p l u g i n s g e t s t a r t e d a u t o m a t i c a l l y b y o p e n i n g a n a s s o c i a t e d l e ( i . e . t e x t l e s ,

c h i p 8 g a m e s ) , o r f r o m t h e O p e n w i t h o p t i o n o n t h e C o n t e x t M e n u .

1 0 . 1 . G a m e s

S e e a l s o t h e C h i p - 8 e m u l a t o r i n s e c t i o n 1 0 . 3 . 2 ( p a g e 1 2 9 ) a n d R o c k b o y i n s e c t i o n 1 0 . 3 . 9

( p a g e 1 3 6 ) .




C h a p t e r 1 0 . P l u g i n s 7 5

1 0 . 1 . 1 . B l a c k j a c k

F i g u r e 1 0 . 1 . : B l a c k j a c k

B l a c k j a c k , a g a m e p l a y e d i n c a s i n o s a r o u n d t h e w o r l d , i s n o w a v a i l a b l e i n t h e p a l m o f

y o u r h a n d ! T h e r u l e s a r e s i m p l e : t r y t o g e t a s c l o s e t o 2 1 w i t h o u t g o i n g o v e r o r s i m p l y

b e a t o u t t h e d e a l e r f o r t h e b e s t h a n d . A l t h o u g h t h i s m a y n o t s e e m d i c u l t , b l a c k j a c k

i s a g a m e r e n o w n e d f o r t h e s t r a t e g y i n v o l v e d . T h i s v e r s i o n i n c l u d e s t h e a b i l i t y t o s p l i t ,

b u y i n s u r a n c e , a n d d o u b l e d o w n .

F o r t h e f u l l s e t o f r u l e s t o t h e g a m e , a n d o t h e r f a c i n a t i n g i n f o r m a t i o n v i s i t

h t t p : / / w w w . b l a c k j a c k i n f o . c o m / b l a c k j a c k - r u l e s . p h p


L e f t / R i g h t /

U p / D o w n

E n t e r b e t t i n g a m o u n t

S e l e c t H i t ( D r a w n e w c a r d ) / S e l e c t

V o l u m e d o w n S t a y ( E n d h a n d )

A D o u b l e d o w n

P o w e r P a u s e g a m e a n d g o t o m e n u / C a n c e l


http://www.blackjackinfo.com/blackjack-rules.php



C h a p t e r 1 0 . P l u g i n s 7 6

1 0 . 1 . 2 . B r i c k M a n i a

F i g u r e 1 0 . 2 . : B r i c k M a n i a

B r i c k M a n i a i s a c l o n e o f t h e c l a s s i c g a m e B r e a k o u t . T h e a i m o f t h e g a m e i s t o d e s t r o y

a l l t h e b r i c k s b y h i t t i n g t h e m w i t h t h e b a l l o n c e o r m o r e . S o m e t i m e s a s p e c i a l i t e m f a l l s

d o w n w h e n y o u d e s t r o y a b r i c k . F o r a s p e c i a l i t e m t o t a k e e e c t , y o u m u s t c a t c h i t w i t h

t h e p a d d l e . L o o k o u t f o r t h e b a d o n e s .

S p e c i a l i t e m s

D i s p l a y e d N a m e D e s c r i p t i o n

N N o r m a l R e t u r n s p a d d l e t o n o r m a l .

D D i e B a l l d i e s ; l o s e a l i f e .

L L i f e G a i n a l i f e .

F F i r e A l l o w s y o u t o s h o o t b r i c k s w i t h p a d d l e .

G G l u e B a l l s t i c k s t o p a d d l e e a c h t i m e i t h i t s .

B B a l l I m m e d i a t e l y r e s a n o t h e r b a l l .

F L F l i p F l i p l e f t / r i g h t m o v e m e n t .




C h a p t e r 1 0 . P l u g i n s 7 7


L e f t / R i g h t M o v e s t h e p a d d l e

S e l e c t / U p R e l e a s e t h e b a l l / F i r e

P o w e r O p e n m e n u / Q u i t

1 0 . 1 . 3 . B u b b l e s

F i g u r e 1 0 . 3 . : B u b b l e s

T h e g o a l o f t h e g a m e i s t o b e a t e a c h l e v e l a s q u i c k l y a s p o s s i b l e b y c l e a r i n g t h e b o a r d o f

a l l b u b b l e s . B u b b l e s a r e r e m o v e d f r o m t h e b o a r d w h e n a c l u s t e r o f t h r e e o f m o r e o f t h e

s a m e t y p e i s f o r m e d . T h e g a m e i s o v e r w h e n a n y b u b b l e s o n t h e b o a r d e x t e n d b e l o w t h e

b o t t o m l i n e . T o m a k e t h i n g s m o r e d i c u l t , t h e e n t i r e b o a r d i s s h i f t e d d o w n e v e r y t i m e

a c e r t a i n n u m b e r o f s h o t s h a v e b e e n r e d . P o i n t s a r e a w a r d e d d e p e n d i n g o n h o w q u i c k l y

t h e l e v e l w a s c o m p l e t e d .


U p F o r w a r d P a u s e g a m e

L e f t / R i g h t V o l u m e D o w n

/ V o l u m e U p

A i m t h e b u b b l e

S e l e c t F i r e b u b b l e

P o w e r E x i t t o m e n u




C h a p t e r 1 0 . P l u g i n s 7 8

1 0 . 1 . 4 . C h e s s b o x

F i g u r e 1 0 . 4 . : C h e s s b o x

C h e s s b o x i s a o n e - p e r s o n c h e s s g a m e w i t h c o m p u t e r a r t i c i a l i n t e l l i g e n c e . T h e c h e s s

e n g i n e i s a p o r t o f G N U C h e s s 2 b y J o h n S t a n b a c k .

I t a l s o w o r k s a s a P G N l e v i e w e r . I n s t e a d o f e x e c u t i n g t h e g a m e f r o m t h e p l u g i n

m e n u , l o o k f o r a n y l e w i t h . p g n e x t e n s i o n i n t h e l e b r o w s e r a n d e x e c u t e i t . C h e s s b o x

w i l l s h o w t h e l i s t o f m a t c h e s i n c l u d e d i n t h e l e a n d a l l o w y o u t o s e l e c t t h e o n e y o u w a n t

t o w a t c h . A f t e r t h a t , y o u c a n s c r o l l b a c k a n d f o r t h t h r o u g h t h e m o v e s o f t h e g a m e . I f

t h e m e n u i s i n v o k e d w h i l e i n t h e v i e w e r , t h e u s e r i s a l l o w e d t o s e l e c t a n e w m a t c h f r o m

t h e s a m e l e o r q u i t t h e g a m e .

F o r c e p l a y w h i l e t h e c o m p u t e r i s t h i n k i n g w i l l c a u s e i t t o m a k e i t s m o v e i m m e d i a t e l y .

I f d o n e w h i l e i t ' s y o u r t u r n , t h e c o m p u t e r w i l l m o v e f o r y o u a n d i p t h e b o a r d s o t h a t

y o u a r e p l a y i n g f r o m t h e o t h e r s i d e . I f y o u w a n t , y o u c a n f o r c e p l a y a n e n t i r e g a m e a n d

w a t c h t h e a r t i c i a l i n t e l l i g e n c e g h t a g a i n s t i t s e l f .

W h e n y o u q u i t t h e g a m e t h e c u r r e n t s t a t e w i l l b e s a v e d a n d r e s t o r e d w h e n y o u r e s u m e

t h e g a m e . T h e m e n u a l s o a l l o w s t h e u s e r t o r e l o a d t h e l a s t g a m e s a v e d , s a v e t h e c u r r e n t

p o s i t i o n a n d s t a r t a n e w g a m e w i t h o u t h a v i n g t o q u i t t h e g a m e .




C h a p t e r 1 0 . P l u g i n s 7 9

K e y s


D i r e c t i o n k e y s M o v e t h e c u r s o r

S e l e c t P i c k u p / D r o p p i e c e

M e n u C h a n g e l e v e l

A F o r c e p l a y

P o w e r S h o w t h e m e n u

1 0 . 1 . 5 . C l i x

F i g u r e 1 0 . 5 . : C l i x

T h e a i m i s t o r e m o v e a l l b l o c k s f r o m t h e b o a r d . Y o u c a n o n l y r e m o v e b l o c k s , i f a t l e a s t

t w o b l o c k s w i t h t h e s a m e c o l o r h a v e a d i r e c t c o n n e c t i o n . T h e m o r e b l o c k s y o u r e m o v e

p e r t u r n , t h e m o r e p o i n t s y o u g e t .



U p / D o w n

M o v e t h e c u r s o r a r o u n d t h e b l o c k s

S e l e c t R e m o v e a b l o c k

P o w e r E x i t




C h a p t e r 1 0 . P l u g i n s 8 0

1 0 . 1 . 6 . C h o p p e r

F i g u r e 1 0 . 6 . : C h o p p e r

N a v i g a t e a c a v e r n o u s m a z e w i t h o u t b a n g i n g i n t o w a l l s , t h e c e i l i n g , o r t h e o o r . H o w

l o n g c a n y o u y y o u r c h o p p e r ?


S e l e c t M a k e c h o p p e r y

M e n u E n t e r m e n u




C h a p t e r 1 0 . P l u g i n s 8 1

1 0 . 1 . 7 . C o d e b u s t e r

F i g u r e 1 0 . 7 . : C o d e b u s t e r

C o d e b u s t e r i s a c l o n e o f t h e c l a s s i c m a s t e r m i n d g a m e . T h e c o m p u t e r s e l e c t s a r a n d o m

c o m b i n a t i o n o f c o l o u r e d p e g s a n d t h e a i m i s t o g u e s s t h e c o r r e c t c o m b i n a t i o n i n t h e

s m a l l e s t n u m b e r o f m o v e s . A f t e r e a c h a t t e m p t t o g u e s s t h e c o m b i n a t i o n t h e r e s u l t s a r e

d i s p l a y e d i n t h e f o r m o f r e d a n d w h i t e p e g s . A r e d p e g s i g n i e s a c o r r e c t p e g i n t h e

c o r r e c t p o s i t i o n , a n d a w h i t e p e g s i g n i e s a c o r r e c t p e g i n t h e w r o n g p o s i t i o n .


P o w e r S h o w m e n u

S e l e c t C h e c k s u g g e s t i o n a n d m o v e t o n e x t l i n e


/ V o l u m e U p

S e l e c t a p e g

U p / D o w n F o r w a r d /

R e w i n d

C h a n g e c u r r e n t p e g

1 0 . 1 . 8 . D i c e

D i c e i s a s i m p l e d i c e r o l l i n g s i m u l a t o r . S e l e c t n u m b e r a n d t y p e o f d i c e t o r o l l i n a m e n u

a n d s t a r t b y c h o o s i n g R o l l D i c e . T h e r e s u l t i s s h o w n a s i n d i v i d u a l n u m b e r s a s w e l l a s

t h e t o t a l o f t h e r o l l e d d i c e .




C h a p t e r 1 0 . P l u g i n s 8 2


S e l e c t R o l l d i c e a g a i n

P o w e r Q u i t

1 0 . 1 . 9 . D o o m

F i g u r e 1 0 . 8 . : D o o m

T h i s i s t h e f a m o u s D o o m g a m e .

G e t t i n g s t a r t e d

F o r t h e g a m e t o r u n y o u n e e d . w a d g a m e l e s l o c a t e d i n / . r o c k b o x / d o o m / o n y o u r

p l a y e r . C r e a t e t h e d i r e c t o r y a n d s a v e t h e f o l l o w i n g l e s t h e r e :

r o c k d o o m . w a d . T h e R o c k b o x . w a d , b a s e d o n p r b o o m . w a d f r o m p r b o o m - 2 . 2 . 6

Y o u r w a d l e s . C o p y a l l D o o m w a d s y o u w i s h t o p l a y i n t o t h a t d i r e c t o r y .

T h e n e e d e d l e s c a n b e f o u n d a t ZP l u g i n D o o m

T o p l a y a d d o n w a d s c r e a t e t h e a d d o n s d i r e c t o r y w i t h i n t h e d o o m d i r e c t o r y . P l a c e w a d

l e s i n t h i s d i r e c t o r y . C u r r e n t l y d o o m o n l y s u p p o r t s a m a x i m u m n u m b e r o f 1 0 a d d o n s .

A f r e e a l t e r n a t i v e f o r D o o m 2 i s F r e e D o o m ( h t t p : / / f r e e d o o m . s o u r c e f o r g e . n e t ) . T h i s c a n

b e u s e d i n p l a c e o f d o o m 2 . w a d

, o r i t m a y b e u s e d a s a n a d d o n i n D o o m , b y p l a c i n g i t i n

t h e a d d o n s d i r e c t o r y .


http://freedoom.sourceforge.net/

http://www.rockbox.org/wiki/PluginDoom



C h a p t e r 1 0 . P l u g i n s 8 3

M e n u s

R o c k d o o m M e n u . T h e R o c k d o o m m e n u i s s h o w n w h e n D o o m i s r s t l a u n c h e d . T h i s i s

t h e o n l y t i m e i t c a n b e a c c e s s e d ( b e f o r e s t a r t i n g t h e g a m e ) . T o r e - a d j u s t R o c k d o o m

o p t i o n s , y o u w i l l n e e d t o q u i t y o u r c u r r e n t g a m e a n d r e s t a r t t h e p l u g i n .

M a i n M e n u . T h e D o o m p l u g i n h a s a m a i n m e n u , w h i c h i s b r o u g h t u p b e f o r e a g a m e

i s s t a r t e d . I t h a s t h e f o l l o w i n g e n t r i e s :

G a m e . S e l e c t w h i c h ( o c i a l ) w a d t o l a u n c h

A d d o n . S e l e c t w h i c h u n o c i a l a d d o n w a d t o l a u n c h ( F r o m / . r o c k b o x / d o o m / a d d o n s

d i r e c t o r y )

D e m o s . S e l e c t w h i c h d e m o l e t o p l a y o n g a m e s t a r t

O p t i o n s . C o n g u r e l o w - l e v e l D o o m o p t i o n s

P l a y G a m e . L a u n c h t h e w a d / a d d o n / D e m o c h o s e n

O p t i o n s M e n u . T h i s m e n u h a s t h e f o l l o w i n g o p t i o n s :

S o u n d . E n a b l e o r D i s a b l e s o u n d i n D o o m

S e t K e y s . C h a n g e t h e g a m e k e y c o n g u r a t i o n

T i m e D e m o . R u n a t i m e d d e m o , t o t e s t g a m e s p e e d o n a p l a y e r ( O n l y r u n s o n

D o o m S h a r e w a r e )

P l a y e r B o b b i n g . E n a b l e o r D i s a b l e p l a y e r u p / D o w n m o v e m e n t

T r a n s l u c e n c y . E n a b l e o r D i s a b l e s p r i t e t r a n s l u c e n c y ( F i r e b a l l s , P l a s m a . . . )

F a k e C o n t r a s t . E n a b l e o r D i s a b l e m o d i e d g a m e l i g h t i n g

A l w a y s R u n . M a k e t h e p l a y e r a l w a y s r u n

H e a d s u p D i s p l a y . S h o w t h e p l a y e r s t a t u s w h e n i n f u l l s c r e e n

S t a t u s b a r A l w a y s R e d . D i s a b l e c o l o u r r e s p o n s e s t a t u s b a r

I n G a m e M a i n M e n u . T h i s m e n u c a n o n l y b e a c c e s s e d f r o m w i t h i n a r u n n i n g g a m e ,

a n d i s d i s p l a y e d b y p r e s s i n g P o w e r

N e w G a m e . S t a r t a n e w g a m e

O p t i o n s . I n g a m e o p t i o n s

L o a d G a m e . L o a d a s a v e d g a m e

S a v e G a m e . S a v e t h e c u r r e n t g a m e

Q u i t . Q u i t t h e g a m e

I n G a m e O p t i o n s M e n u . T h i s m e n u h a s t h e f o l l o i n g o p t i o n s :

E n d G a m e . E n d s t h e c u r r e n t g a m e

M e s s a g e s . E n a b l e o r D i s a b l e i n g a m e m e s s a g e s

S c r e e n S i z e . S h r i n k o r E n l a r g e t h e d i s p l a y e d p o r t i o n o f t h e g a m e

G a m m a . C h a n g e t h e b r i g h t n e s s ( G a m m a ) o f t h e g a m e

S o u n d V o l u m e . C h a n g e t h e s o u n d , m u s i c a n d s y s t e m v o l u m e

N o t e : I n g a m e m u s i c i s n o t c u r r e n t l y s u p p o r t e d b




C h a p t e r 1 0 . P l u g i n s 8 4

K e y s


U p M o v e F o r w a r d

D o w n D o w n

L e f t T u r n L e f t

R i g h t T u r n R i g h t

A S h o o t

M e n u O p e n

P o w e r I n G a m e M e n u

S e l e c t E n t e r

V o l u m e d o w n C h a n g e W e a p o n

P l a y i n g t h e g a m e

A f t e r i n s t a l l a t i o n o f t h e w a d l e s i s c o m p l e t e y o u c a n s t a r t t h e g a m e . m o r e d e s c r i p t i o n

i s n e e d e d

1 0 . 1 . 1 0 . F l i p i t

F i g u r e 1 0 . 9 . : F l i p i t




C h a p t e r 1 0 . P l u g i n s 8 5

F l i p p i n g t h e c o l o u r o f t h e t o k e n u n d e r t h e c u r s o r a l s o i p s t h e t o k e n s a b o v e , b e l o w , l e f t

a n d r i g h t o f t h e c u r s o r . T h e a i m i s t o e n d u p w i t h a s c r e e n c o n t a i n i n g t o k e n s o f o n l y o n e

c o l o u r .


U p / D o w n /

L e f t / R i g h t

M o v e t h e c u r s o r

S e l e c t F l i p

M e n u S h u e

V o l u m e u p S o l v e

V o l u m e d o w n S o l v e s t e p b y s t e p

P o w e r Q u i t t h e g a m e

1 0 . 1 . 1 1 . G o b a n

F i g u r e 1 0 . 1 0 . : G o b a n

G o b a n i s a a p l u g i n f o r p l a y i n g , v i e w i n g a n d r e c o r d i n g g a m e s o f G o ( a l s o k n o w n a s

W e i q i , B a d u k , I g o a n d G o e ) . I t u s e s s t a n d a r d S m a r t G a m e F o r m a t ( S G F ) l e s f o r s a v -

i n g a n d l o a d i n g g a m e s . Y o u c a n n d a s h o r t i n t r o d u c t i o n t o G o a t h t t p : / / s e n s e i s . x m p .

n e t / ? W h a t I s G o a n d m o r e i n f o r m a t i o n a b o u t S G F l e s c a n b e r e a d a t h t t p : / / s e n s e i s . x m p .


http://senseis.xmp.net/?SmartGameFormat


http://senseis.xmp.net/?WhatIsGo

http://senseis.xmp.net/?WhatIsGo



C h a p t e r 1 0 . P l u g i n s 8 6

n e t / ? S m a r t G a m e F o r m a t o r t h e S G F s p e c i c a t i o n a t h t t p : / / w w w . r e d - b e a n . c o m / s g f / .

T h i s p l u g i n c a n l o a d a l l m o d e r n S G F l e s ( l e f o r m a t 3 o r 4 ) w i t h f e w p r o b l e m s . I t

a t t e m p t s t o p r e s e r v e S G F p r o p e r t i e s w h i c h i t d o e s n ' t u n d e r s t a n d , a n d m o s t c o m m o n

S G F p r o p e r t i e s a r e h a n d l e d f u l l y . I t i s p o s s i b l e t o v i e w ( a n d e d i t i f y o u l i k e ) K o g o ' s

J o s e k i D i c t i o n a r y ( h t t p : / / w a t e r r e . u s / j o s e k i . h t m ) w i t h t h i s p l u g i n , a l t h o u g h t h e l o a d a n d

s a v e t i m e s c a n b e o n t h e o r d e r o f a m i n u t e o r t w o o n p a r t i c u l a r l y s l o w d e v i c e s . L a r g e

S G F l e s m a y s t o p a u d i o p l a y b a c k f o r t h e d u r a t i o n o f t h e p l u g i n ' s r u n i n o r d e r t o f r e e

u p m o r e m e m o r y a n d s o m e v e r y l a r g e S G F l e s w i l l n o t e v e n l o a d o n d e v i c e s w i t h l i t t l e

a v a i l a b l e m e m o r y .

N o t e : T h e p l u g i n d o e s N O T s u p p o r t S G F l e s w i t h m u l t i p l e g a m e s i n o n e l e . T h e s e ba r e r a r e , b u t i f y o u h a v e o n e d o n ' t e v e n t r y i t ( t h e l e w i l l m o s t l i k e l y b e c o r r u p t e d i f

y o u s a v e o v e r i t ) . Y o u h a v e b e e n w a r n e d .

T h e l e / s g f / g b n _ d e f . s g f i s u s e d b y t h e p l u g i n t o s t o r e a n y u n s a v e d c h a n g e s i n t h e

m o s t r e c e n t l y l o a d e d g a m e . T h i s m e a n s t h a t i f y o u f o r g e t t o s a v e y o u r c h a n g e s , y o u

s h o u l d l o a d / s g f / g b n _ d e f . s g f i m m e d i a t e l y t o o o a d t h e c h a n g e s t o a n o t h e r l e . I f y o u

l o a d a n o t h e r l e r s t t h e n y o u r c h a n g e s w i l l b e l o s t p e r m a n e n t l y . T h e / s g f / g b n _ d e f . s g f

l e i s a l s o t h e l e l o a d e d i f a n o t h e r i s n o t s e l e c t e d .

T h e i n f o r m a t i o n p a n e l w h i c h d i s p l a y s t h e c u r r e n t m o v e n u m b e r m a y a l s o c o n t a i n t h e s e

m a r k e r s :

M a r k M e a n i n g

+ T h e r e a r e n o d e s a f t e r t h e c u r r e n t n o d e i n t h e S G F t r e e .

* T h e r e a r e s i b l i n g v a r i a t i o n s w h i c h c a n b e n a v i g a t e d t o u s i n g t h e N e x t V a r i a -

t i o n m e n u o p t i o n o f t h e C o n t e x t M e n u o r t h e A b u t t o n .

C T h e r e i s a c o m m e n t a t t h e c u r r e n t n o d e . I t c a n b e v i e w e d / e d i t e d u s i n g t h e

A d d / E d i t C o m m e n t m e n u o p t i o n o f t h e C o n t e x t M e n u .


http://waterfire.us/joseki.htm

http://www.red-bean.com/sgf/





C h a p t e r 1 0 . P l u g i n s 8 7

C o n t r o l s


U p M o v e c u r s o r u p

D o w n M o v e c u r s o r d o w n

L e f t M o v e c u r s o r l e f t

R i g h t M o v e c u r s o r r i g h t

S e l e c t P l a y a m o v e ( o r u s e a t o o l i f p l a y - m o d e

h a s b e e n c h a n g e d ) .

V o l u m e d o w n R e t r e a t o n e n o d e i n t h e g a m e t r e e

V o l u m e u p A d v a n c e o n e n o d e i n t h e g a m e t r e e

M e n u M a i n M e n u

L o n g S e l e c t C o n t e x t M e n u

A G o t o t h e n e x t v a r i a t i o n w h e n a t t h e r s t

n o d e i n a b r a n c h

M e n u s

M a i n M e n u . T h e m a i n m e n u f o r g a m e s e t u p a n d a c c e s s t o o t h e r m e n u s .

N e w . C r e a t e a n e w g a m e w i t h y o u r c h o i c e o f b o a r d s i z e a n d h a n d i c a p s .

S a v e . S a v e t h e c u r r e n t s t a t e o f t h e g a m e . I t w i l l b e s a v e d t o / s g f / g b n _ d e f . s g f

u n l e s s o t h e r w i s e s e t .

S a v e A s . S a v e t o a s p e c i e d l e .

G a m e I n f o . V i e w a n d m o d i f y t h e m e t a d a t a o f t h e c u r r e n t g a m e .

P l a y b a c k C o n t r o l . C o n t r o l t h e p l a y b a c k o f t h e c u r r e n t p l a y l i s t a n d m o d i f y t h e

v o l u m e o f y o u r p l a y e r .

Z o o m L e v e l . Z o o m i n o r o u t o n t h e b o a r d . I f y o u s e t t h e z o o m l e v e l , i t w i l l b e

s a v e d a n d u s e d a g a i n t h e n e x t t i m e y o u o p e n t h i s p l u g i n .

O p t i o n s . O p e n t h e O p t i o n s M e n u .

C o n t e x t M e n u . O p e n t h e C o n t e x t M e n u w h i c h a l l o w s y o u t o s e t p l a y m o d e s a n d

o t h e r t o o l s .

Q u i t . L e a v e t h e p l u g i n . A n y u n s a v e d c h a n g e s a r e s a v e d t o / s g f / g b n _ d e f . s g f .

G a m e I n f o . T h e m e n u f o r m o d i f y i n g g a m e i n f o ( m e t a d a t a ) o f t h e c u r r e n t g a m e . T h i s

i n f o r m a t i o n w i l l b e s a v e d t o t h e S G F l e a n d c a n b e v i e w e d i n a l m o s t a l l S G F

r e a d e r s .

B a s i c I n f o . S h o w s a q u i c k v i e w o f t h e b a s i c g a m e m e t a d a t a , i f a n y h a s b e e n s e t

( o t h e r w i s e d o e s n o t h i n g ) . T h i s o p t i o n d o e s n o t a l l o w e d i t i n g .

T i m e L i m i t . T h e t i m e l i m i t o f t h e c u r r e n t g a m e .




C h a p t e r 1 0 . P l u g i n s 8 8

O v e r t i m e . T h e o v e r t i m e s e t t i n g s o f t h e c u r r e n t g a m e .

R e s u l t . T h e r e s u l t o f t h e c u r r e n t g a m e . T h i s t e x t m u s t f o l l o w t h e f o r m a t s p e c i e d

a t h t t p : / / w w w . r e d - b e a n . c o m / s g f / p r o p e r t i e s . h t m l # R E t o b e r e a d b y o t h e r S G F

r e a d e r s . S o m e e x a m p l e s a r e B + R ( B l a c k w i n s b y r e s i g n a t i o n ) , B + 5 . 5 ( B l a c k

w i n s b y 5 . 5 p o i n t s ) , W + T ( W h i t e w i n s o n T i m e ) .

H a n d i c a p . T h e h a n d i c a p o f t h e c u r r e n t g a m e .

K o m i . T h e k o m i o f t h e c u r r e n t g a m e ( c o m p e n s a t i o n t o t h e w h i t e p l a y e r f o r b l a c k

h a v i n g t h e r s t m o v e ) .

R u l e s e t . T h e n a m e o f t h e r u l e s e t i n u s e f o r t h i s g a m e . T h e N Z a n d G O E r u l e s e t s

i n c l u d e s u i c i d e a s a l e g a l m o v e ( f o r m u l t i - s t o n e s u i c i d e o n l y ) ; t h e r e s t d o n o t .

B l a c k P l a y e r . T h e n a m e o f t h e b l a c k p l a y e r .

B l a c k R a n k . B l a c k ' s r a n k , i n d a n o r k y u .

B l a c k T e a m . T h e n a m e o f b l a c k ' s t e a m , i f a n y .

W h i t e P l a y e r . T h e n a m e o f t h e w h i t e p l a y e r .

W h i t e R a n k . W h i t e ' s r a n k , i n d a n o r k y u .

W h i t e T e a m . T h e n a m e o f w h i t e ' s t e a m , i f a n y .

D a t e . T h e d a t e t h a t t h i s g a m e t o o k p l a c e . T h i s t e x t m u s t f o l l o w t h e f o r m a t

s p e c i e d a t h t t p : / / w w w . r e d - b e a n . c o m / s g f / p r o p e r t i e s . h t m l # D T t o b e r e a d b y

o t h e r S G F r e a d e r s .

E v e n t . T h e n a m e o f t h e e v e n t w h i c h t h i s g a m e w a s a p a r t o f , i f a n y .

P l a c e . T h e p l a c e t h a t t h i s g a m e t o o k p l a c e .

R o u n d . I f p a r t o f a t o u r n a m e n t , t h e r o u n d n u m b e r f o r t h i s g a m e .

D o n e . R e t u r n t o t h e p r e v i o u s m e n u .

O p t i o n s . C u s t o m i z e t h e b e h a v i o r o f t h e p l u g i n i n c e r t a i n w a y s .

S h o w C h i l d V a r i a t i o n s ? E n a b l e t h i s t o m a r k c h i l d v a r i a t i o n s o n h e b o a r d i f t h e r e

a r e m o r e t h a n o n e . N o t e : v a r i a t i o n s w h i c h d o n ' t s t a r t w i t h a m o v e a r e n o t

v i s i b l e i n t h i s w a y .

D i s a b l e I d l e P o w e r o ? E n a b l e t h i s i f y o u d o n o t w a n t t h e p l a y e r t o t u r n o a f t e r

a c e r t a i n p e r i o d o f i n a c t i v i t y ( d e p e n d s o n y o u r g l o b a l R o c k b o x s e t t i n g s ) .

I d l e A u t o s a v e T i m e . S e t t h e a m o u n t o f i d l e t i m e t o w a i t b e f o r e a u t o m a t i c a l l y

s a v i n g a n y u n s a v e d c h a n g e s . T h e s e a u t o s a v e s g o t o t h e l e / s g f / g b n _ d e f . s g f

r e g a r d l e s s o f i f y o u h a v e l o a d e d a g a m e o r u s e d S a v e A s t o s a v e t h e g a m e

b e f o r e o r n o t . S e t t o O f f t o d i s a b l e t h i s f u n c t i o n a l i t y c o m p l e t e l y .

A u t o m a t i c a l l y S h o w C o m m e n t s ? I f t h i s i s e n a b l e d a n d y o u n a v i g a t e t o a n o d e

c o n t a i n i n g g a m e c o m m e n t s , t h e y w i l l a u t o m a t i c a l l y b e d i s p l a y e d .

C o n t e x t M e n u . T h e m e n u f o r c h o o s i n g d i e r e n t p l a y m o d e s a n d t o o l s , a d d i n g o r e d i t i n g

c o m m e n t s , a d d i n g p a s s m o v e s , o r s w i t c h i n g b e t w e e n s i b l i n g v a r i a t i o n s .


http://www.red-bean.com/sgf/properties.html#DT

http://www.red-bean.com/sgf/properties.html#RE



C h a p t e r 1 0 . P l u g i n s 8 9

P l a y M o d e . P l a y m o v e s n o r m a l l y o n t h e b o a r d . I f t h e r e a r e c h i l d m o v e s f r o m t h e

c u r r e n t n o d e , t h i s m o d e w i l l l e t y o u f o l l o w v a r i a t i o n s b y s i m p l y p l a y i n g t h e

r s t m o v e i n t h e s e q u e n c e . U n l e s s i t i s f o l l o w i n g a v a r i a t i o n , t h i s m o d e w i l l

n o t a l l o w y o u t o p l a y i l l e g a l m o v e s . T h i s i s t h e d e f a u l t m o d e b e f o r e a n o t h e r

i s s e t a f t e r l o a d i n g a g a m e o r c r e a t i n g a n e w o n e .

A d d B l a c k M o d e . A d d b l a c k s t o n e s t o t h e b o a r d a s d e s i r e d . T h e s e s t o n e s a r e n o t

m o v e s a n d d o n o t p e r f o r m c a p t u r e s o r c o u n t a s k o t h r e a t s .

A d d W h i t e M o d e . A d d w h i t e s t o n e s t o t h e b o a r d a s d e s i r e d . T h e s e s t o n e s a r e n o t

m o v e s a n d d o n o t p e r f o r m c a p t u r e s o r c o u n t a s k o t h r e a t s .

E r a s e S t o n e M o d e . R e m o v e s t o n e s f r o m t h e b o a r d a s d e s i r e d . T h e s e r e m o v e d

s t o n e s a r e n o t c o u n t e d a s c a p t u r e d , t h e y a r e s i m p l y r e m o v e d .

P a s s . P l a y a s i n g l e p a s s m o v e . T h i s d o e s n o t c h a n g e t h e m o d e o f p l a y .

N e x t V a r i a t i o n . I f t h e g a m e i s a t t h e r s t m o v e i n a v a r i a t i o n , t h i s w i l l n a v i g a t e

t o t h e n e x t v a r i a t i o n a f t e r t h e c u r r e n t o n e . T h i s i s t h e o n l y w a y t o r e a c h

v a r i a t i o n s w h i c h s t a r t w i t h a d d i n g o r r e m o v i n g s t o n e s , a s y o u c a n n o t f o l l o w

t h e m b y p l a y i n g t h e s a m e m o v e .

F o r c e P l a y M o d e . T h e s a m e a s P l a y M o d e e x c e p t t h a t t h i s m o d e w i l l a l l o w y o u

t o p l a y i l l e g a l m o v e s s u c h a s r e t a k i n g a k o i m m e d i a t e l y w i t h o u t a k o t h r e a t ,

s u i c i d e o n r u l e s e t s w h i c h d o n ' t a l l o w i t ( i n c l u d i n g s i n g l e s t o n e s u i c i d e ) , a n d

p l a y i n g a m o v e w h e r e t h e r e i s a l r e a d y a s t o n e .

M a r k M o d e . A d d g e n e r i c m a r k s t o t h e b o a r d , o r r e m o v e t h e m .

C i r c l e M o d e . A d d c i r c l e m a r k s t o t h e b o a r d , o r r e m o v e t h e m .

S q u a r e M o d e . A d d s q u a r e m a r k s t o t h e b o a r d , o r r e m o v e t h e m .

T r i a n g l e M o d e . A d d t r i a n g l e m a r k s t o t h e b o a r d , o r r e m o v e t h e m .

L a b e l M o d e . A d d o n e c h a r a c t e r l a b e l s t o t h e b o a r d . E a c h l a b e l s t a r t s a t t h e

l e t t e r ` a ' a n d e a c h s u b s e q u e n t a p p l i c a t i o n o f a l a b e l w i l l i n c r e m e n t t h e l e t t e r .

T o r e m o v e a l a b e l , c l i c k o n i t u n t i l i t c y c l e s t h r o u g h t h e a l l o w e d l e t t e r s a n d

d i s a p p e a r s .

A d d / E d i t C o m m e n t . A d d o r e d i t a c o m m e n t a t t h e c u r r e n t n o d e .

D o n e . G o b a c k t o t h e p r e v i o u s s c r e e n .




C h a p t e r 1 0 . P l u g i n s 9 0

1 0 . 1 . 1 2 . I n v a d r o x

F i g u r e 1 0 . 1 1 . : I n v a d r o x

I n v a d r o x i s a c l o n e o f t h e c l a s s i c a r c a d e g a m e S p a c e I n v a d e r s . K i l l t h o s e p e s k y a l i e n s

b e f o r e t h e y g e t t o y o u . R e m e m b e r , t h e y i n c r e a s e s p e e d , d r o p d o w n a n d r e v e r s e d i r e c t i o n

a f t e r e v e r y p a s s !


L e f t M o v e l e f t

R i g h t M o v e r i g h t

S e l e c t F i r e

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 9 1

1 0 . 1 . 1 3 . J a c k p o t

F i g u r e 1 0 . 1 2 . : J a c k p o t

T h i s i s a j a c k p o t s l o t m a c h i n e g a m e . A t t h e b e g i n n i n g o f t h e g a m e y o u h a v e 2 0 $ . P a y o u t s

a r e g i v e n w h e n t h r e e m a t c h i n g s y m b o l s c o m e u p .


S e l e c t P l a y

P o w e r E x i t t h e g a m e




C h a p t e r 1 0 . P l u g i n s 9 2

1 0 . 1 . 1 4 . J e w e l s

F i g u r e 1 0 . 1 3 . : J e w e l s

J e w e l s i s a s i m p l e y e t a d d i c t i n g g a m e w h i c h i n v o l v e s s w a p p i n g p a i r s o f j e w e l s i n o r d e r t o

f o r m c o n n e c t e d s e g m e n t s o f t h r e e o r m o r e o f t h e s a m e t y p e .

T h e g o a l o f t h e g a m e i s t o s c o r e a s m a n y p o i n t s a s p o s s i b l e b e f o r e r u n n i n g o u t o f

a v a i l a b l e m o v e s . H i g h e r p o i n t s a r e a w a r d e d t o l a r g e r c o m b o s . T h e g a m e a d v a n c e s t o t h e

n e x t l e v e l a f t e r e v e r y o n e h u n d r e d p o i n t s a n d r a n d o m l y c l e a r s s e v e r a l j e w e l s .

I n p u z z l e m o d e t h e a i m o f t h e g a m e i s t o c o n n e c t t h e p u z z l e s , b y s k i l f u l s w a p p i n g p a i r s

o f j e w e l s .



U p / D o w n

M o v e t h e c u r s o r a r o u n d t h e j e w e l s

S e l e c t S e l e c t a j e w e l

P o w e r M e n u




C h a p t e r 1 0 . P l u g i n s 9 3

1 0 . 1 . 1 5 . M a z e z a M

F i g u r e 1 0 . 1 4 . : M a z e z a M

T h e g o a l o f t h i s p u z z l e g a m e i s t o e s c a p e a d u n g e o n c o n s i s t i n g o f t e n m a z e z a m s . T h e s e

a r e r o o m s c o n t a i n i n g r o w s o f b l o c k s w h i c h c a n b e s h i f t e d l e f t o r r i g h t . Y o u c a n m o v e

t h e r o w s o n l y b y p u s h i n g t h e m a n d i f y o u m o v e t h e r o w s c a r e l e s s l y , y o u w i l l g e t s t u c k .

Y o u c a n h a v e a n o t h e r g o b y s e l e c t i n g r e t r y l e v e l f r o m t h e m e n u , b u t t h i s w i l l c o s t y o u

a l i f e . Y o u s t a r t t h e g a m e w i t h t h r e e l i v e s . L u c k i l y , t h e r e a r e c h e c k p o i n t s a t l e v e l s f o u r

a n d e i g h t .


U p , D o w n ,

L e f t , R i g h t

F o r w a r d ,

R e w i n d ,

V o l u m e D o w n ,

V o l u m e U p

M o v e C h a r a c t e r

P o w e r M e n u




C h a p t e r 1 0 . P l u g i n s 9 4

1 0 . 1 . 1 6 . M i n e s w e e p e r

F i g u r e 1 0 . 1 5 . : M i n e s w e e p e r p l u g i n

T h e c l a s s i c g a m e o f m i n e s w e e p e r . T h e a i m o f t h e g a m e i s t o u n c o v e r a l l o f t h e s q u a r e s

o n t h e b o a r d . I f a m i n e i s u n c o v e r e d t h e n t h e g a m e i s o v e r . I f a m i n e i s n o t u n c o v e r e d ,

t h e n t h e n u m b e r o f m i n e s a d j a c e n t t o t h e c u r r e n t s q u a r e i s r e v e a l e d . T h e a i m i s t o u s e

t h e i n f o r m a t i o n y o u a r e g i v e n t o w o r k o u t w h e r e t h e m i n e s a r e a n d a v o i d t h e m . W h e n

t h e p l a y e r i s c e r t a i n t h a t t h e y k n o w t h e l o c a t i o n o f a m i n e , i t c a n b e t a g g e d t o a v o i d

a c c i d e n t a l l y s t e p p i n g o n i t .


U p / D o w n /

L e f t / R i g h t

M o v e t h e c u r s o r a c r o s s t h e m i n e e l d

A T o g g l e a g o n / o

S e l e c t R e v e a l t h e c o n t e n t s o f t h e c u r r e n t s q u a r e

M e n u D i s p l a y t h e c u r r e n t g a m e s t a t u s





C h a p t e r 1 0 . P l u g i n s 9 5

1 0 . 1 . 1 7 . P a c b o x

F i g u r e 1 0 . 1 6 . : P a c b o x

P a c b o x i s a n e m u l a t o r o f t h e P a c m a n a r c a d e m a c h i n e h a r d w a r e . I t i s a p o r t o f P I E

P a c m a n I n s t r u c t i o n a l E m u l a t o r ( h t t p : / / w w w . a s c o t t i . o r g / p r o g r a m m i n g / p i e / p i e . h t m ) .

R O M s

T o u s e t h e e m u l a t o r t o p l a y P a c m a n , y o u n e e d a c o p y o f R O M s f o r M i d w a y P a c m a n .

F i l e n a m e M D 5 c h e c k s u m

p a c m a n . 5 e 2 7 9 1 4 5 5 b a b a f 2 6 e 0 b 3 9 6 c 7 8 d 2 b 4 5 f 8 f 6

p a c m a n . 5 f 9 2 4 0 f 3 5 d 1 d 2 b e e e 0 1 7 1 9 5 6 5 3 b 5 e 4 0 5

p a c m a n . 6 e 2 9 0 a a 5 e a e 9 e 2 f 6 3 5 8 7 b 5 d d 5 a 7 d a 9 3 2 d a

p a c m a n . 6 f 1 9 a 8 8 6 f c d 8 b 5 e 8 8 b 0 e d 1 b 9 7 f 9 d 8 6 5 9 c 0

p a c m a n . 6 h d 7 c c e 8 b d 9 5 6 3 b 1 3 3 e c 1 7 e b b b 6 3 7 3 d 4

p a c m a n . 6 j 3 3 c 0 e 1 9 7 b e 4 c 7 8 7 1 4 2 a f 6 c 3 b e 0 d 8 f 6 b 0

T h e s e n e e d t o b e s t o r e d i n t h e / . r o c k b o x / p a c m a n / d i r e c t o r y o n y o u r p l a y e r . I n t h e

M A M E R O M s c o l l e c t i o n t h e n e c e s s a r y l e s c a n b e f o u n d i n p a c m a n . z i p a n d p u c k m a n . z i p .

T h e M A M E p r o j e c t i t s e l f c a n b e f o u n d a t h t t p : / / w w w . m a m e . n e t .


http://www.mame.net/

http://www.ascotti.org/programming/pie/pie.htm



C h a p t e r 1 0 . P l u g i n s 9 6

K e y s


U p M o v e U p

D o w n M o v e D o w n

L e f t M o v e L e f t

R i g h t M o v e R i g h t

A I n s e r t C o i n

S e l e c t 1 - P l a y e r S t a r t

P o w e r 2 - P l a y e r S t a r t

M e n u M e n u

1 0 . 1 . 1 8 . P e g b o x

F i g u r e 1 0 . 1 7 . : p e g b o x

T o b e a t e a c h l e v e l , y o u m u s t d e s t r o y a l l o f t h e p e g s . I f t w o l i k e p e g s a r e p u s h e d i n t o

e a c h o t h e r t h e y d i s a p p e a r e x c e p t f o r t r i a n g l e s w h i c h f o r m a s o l i d b l o c k a n d c r o s s e s w h i c h

a l l o w y o u t o c h o o s e a r e p l a c e m e n t b l o c k .




C h a p t e r 1 0 . P l u g i n s 9 7


U p , D o w n ,

L e f t , R i g h t

t o m o v e a r o u n d

S e l e c t t o c h o o s e p e g

A t o r e s t a r t l e v e l

V o l u m e u p t o g o u p a l e v e l

V o l u m e d o w n t o g o d o w n a l e v e l

P o w e r t o q u i t

1 0 . 1 . 1 9 . P o n g

F i g u r e 1 0 . 1 8 . : P o n g

P o n g i s a s i m p l e o n e o r t w o p l a y e r t e n n i s g a m e . W h e n e v e r a p l a y e r m i s s e s t h e b a l l t h e

o t h e r s c o r e s .

T h e g a m e s t a r t s i n d e m o m o d e , w i t h t h e C P U c o n t r o l l i n g b o t h s i d e s .

A s s o o n a s a b u t t o n t o c o n t r o l o n e o f t h e p a d d l e s i s p r e s s e d , c o n t r o l o f t h a t p a d d l e

p a s s e s t o t h e p l a y e r , s o f o r a s i n g l e p l a y e r g a m e , j u s t p r e s s t h e a p p r o p r i a t e b u t t o n s t o

c o n t r o l t h e s i d e y o u w a n t t o p l a y . F o r a t w o p l a y e r g a m e , b o t h p l a y e r s s h o u l d j u s t p r e s s

t h e a p p r o p r i a t e b u t t o n s f o r t h e i r s i d e .




C h a p t e r 1 0 . P l u g i n s 9 8


U p L e f t p l a y e r u p

D o w n L e f t p l a y e r d o w n

V o l u m e u p R i g h t p l a y e r u p

V o l u m e d o w n R i g h t p l a y e r d o w n

P o w e r Q u i t

1 0 . 1 . 2 0 . R e v e r s i

T h i s i s a s i m p l e i m p l e m e n t a t i o n o f t h e R e v e r s i g a m e . T h e o b j e c t i v e o f t h e g a m e i s t o

h a v e a m a j o r i t y o f o w n c o l o u r e d p i e c e s s h o w i n g a t t h e e n d o f t h e g a m e . T h e g a m e r u l e s

c a n b e f o u n d i n t h e i n t e r n e t .

Y o u c a n c h o o s e t o p l a y m a n u a l l y ( y o u p l a c e b o t h t h e w h i t e a n d d a r k p i e c e s ) o r t o p l a y

a g a i n s t a ( n o t v e r y s m a r t ) r o b o t .

1 0 . 1 . 2 1 . R o b o t n d s k i t t e n

F i g u r e 1 0 . 1 9 . : R o b o t n d s k i t t e n

I n t h i s g a m e , y o u a r e r o b o t ( # ) . Y o u r j o b i s t o n d k i t t e n . T h i s t a s k i s c o m p l i c a t e d

b y t h e e x i s t e n c e o f v a r i o u s t h i n g s w h i c h a r e n o t k i t t e n . R o b o t m u s t t o u c h i t e m s t o

d e t e r m i n e i f t h e y a r e k i t t e n o r n o t . T h e g a m e e n d s w h e n r o b o t n d s k i t t e n .




C h a p t e r 1 0 . P l u g i n s 9 9


U p , D o w n ,

L e f t , R i g h t

F o r w a r d ,

R e w i n d ,

V o l u m e D o w n ,

V o l u m e U p

M o v e r o b o t

P o w e r Q u i t

1 0 . 1 . 2 2 . R o c k b l o x

F i g u r e 1 0 . 2 0 . : R o c k b l o x

R o c k b l o x i s a R o c k b o x v e r s i o n o f t h e c l a s s i c f a l l i n g b l o c k s g a m e f r o m R u s s i a . T h e a i m o f

t h e g a m e i s t o m a k e t h e f a l l i n g b l o c k s o f d i e r e n t s h a p e s f o r m f u l l r o w s . W h e n e v e r a r o w

i s c o m p l e t e d , i t w i l l b e c l e a r e d a w a y , a n d y o u g a i n p o i n t s . F o r e v e r y t e n l i n e s c o m p l e t e d ,

t h e g a m e l e v e l i n c r e a s e s , m a k i n g t h e b l o c k s f a l l f a s t e r . I f t h e p i l e o f b l o c k s r e a c h e s t h e

c e i l i n g , t h e g a m e i s o v e r .




C h a p t e r 1 0 . P l u g i n s 1 0 0


A R e s t a r t g a m e

L e f t M o v e l e f t

R i g h t M o v e r i g h t

D o w n M o v e d o w n

V o l u m e u p R o t a t e a n t i c l o c k w i s e

V o l u m e d o w n R o t a t e c l o c k w i s e

S e l e c t D r o p

H o l d s w i t c h P a u s e

P o w e r Q u i t

1 0 . 1 . 2 3 . R o c k b l o x 1 d

R o c k b l o x 1 d i s a g a m e f o r p e o p l e w h o n d r o c k b l o x t o o h a r d . I n t h i s v e r s i o n t h e s e c o n d

d i m e n s i o n i s m i s s i n g s o t h e u s e r o n l y h a s t o m o v e t h e b r i c k s d o w n . N o h o r i z o n t a l m o v i n g

a n y m o r e a n d n o n e e d t o r o t a t e t h e b r i c k !


S e l e c t M o v e d o w n f a s t e r

P o w e r Q u i t

1 0 . 1 . 2 4 . R o c k l i f e

T h i s a n i m p l e m e n t a t i o n o f J . H . C o n w a y ' s G a m e o f L i f e ( s e e h t t p : / / e n . w i k i p e d i a . o r g / w i k i /

C o n w a y % 2 7 s _ G a m e _ o f _ L i f e f o r a d e t a i l e d d e s c r i p t i o n ) .

R o c k b o x c a n o p e n l e s w i t h a c o n g u r a t i o n d e s c r i p t i o n ( . c e l l s l e s ) . J u s t p l a y

s u c h l e a n d t h e g a m e c o n g u r a t i o n s t o r e d i n i t w i l l b e l o a d e d i n t o t h i s p l u g i n .

A . c e l l s l e i s a t e x t l e . A c a p i t a l ` O ' m a r k s a l i v e c e l l , a d o t m a r k s a d e a d c e l l ,

a l l o t h e r c h a r a c t e r s a r e i g n o r e d . E v e r y t h i n g o n a l i n e s t a r t i n g w i t h a n e x c l a m a t i o n s i g n

( a n d i n c l u d i n g i t ) i s a c o m m e n t a n d i s i g n o r e d .


S e l e c t P l a y / p a u s e

D o w n R e w i n d C h a n g e g r o w t h m o d e

R i g h t V o l u m e U p N e x t g e n e r a t i o n

L e f t V o l u m e D o w n S t a t u s ( o n l y w h e n p a u s e d )

P o w e r E x i t


http://en.wikipedia.org/wiki/Conway%27s_Game_of_Life

http://en.wikipedia.org/wiki/Conway%27s_Game_of_Life



C h a p t e r 1 0 . P l u g i n s 1 0 1

1 0 . 1 . 2 5 . S l i d i n g P u z z l e

F i g u r e 1 0 . 2 1 . : S l i d i n g p u z z l e

T h e c l a s s i c s l i d i n g p u z z l e g a m e . R e a r r a n g e t h e p i e c e s s o t h a t y o u c a n s e e t h e w h o l e

p i c t u r e , o r s w i t c h t o n u m b e r t i l e s i f y o u l i k e i t a l i t t l e e a s i e r I n c l u d e s o n e p i c t u r e p u z z l e ,

b u t y o u c a n s w i t c h t h e p u z z l e p i c t u r e t o b e t h e a l b u m a r t o f t h e c u r r e n t l y p l a y i n g m u s i c

t r a c k , i f o n e e x i s t s ( s e e s e c t i o n B . 2 1 ( p a g e 1 9 3 ) ) . Y o u c a n a l s o u s e t h e s l i d i n g p u z z l e

p l u g i n a s a v i e w e r f o r s u p p o r t e d i m a g e t y p e s , t o t u r n y o u r o w n p i c t u r e s i n t o a p u z z l e .

K e y c o n t r o l s :


L e f t , R i g h t , U p

a n d D o w n

M o v e T i l e

S e l e c t S h u e

A S w i t c h b e t w e e n p i c t u r e s ( d e f a u l t p u z -

z l e , a l b u m a r t , a n d y o u r o w n i m a g e i f

l a u n c h e d v i a O p e n W i t h ) , a n d n u m b e r e d

t i l e s

P o w e r S t o p t h e g a m e




C h a p t e r 1 0 . P l u g i n s 1 0 2

1 0 . 1 . 2 6 . S n a k e

F i g u r e 1 0 . 2 2 . : S n a k e

T h i s i s t h e p o p u l a r s n a k e g a m e . T h e a i m i s t o g r o w y o u r s n a k e a s l a r g e a s p o s s i b l e b y

e a t i n g t h e d o t s t h a t a p p e a r o n t h e s c r e e n . T h e g a m e w i l l e n d w h e n t h e s n a k e t o u c h e s

e i t h e r t h e b o r d e r s o f t h e s c r e e n o r i t s e l f .


U p / D o w n C h a n g e l e v e l s ( 1 i s s l o w e s t , 9 i s f a s t e s t )

S e l e c t T o g g l e P l a y / P a u s e




C h a p t e r 1 0 . P l u g i n s 1 0 3

1 0 . 1 . 2 7 . S n a k e 2

F i g u r e 1 0 . 2 3 . : S n a k e 2 T h e S n a k e S t r i k e s B a c k

A n o t h e r v e r s i o n o f t h e S n a k e g a m e . M o v e t h e s n a k e a r o u n d , a n d e a t t h e a p p l e s t h a t p o p

u p o n t h e s c r e e n . E a c h t i m e a n a p p l e i s e a t e n , t h e s n a k e g e t s l o n g e r . T h e g a m e e n d s

w h e n t h e s n a k e h i t s a w a l l , o r r u n s i n t o i t s e l f .


I n m e n u

U p / D o w n S e t g a m e s p e e d

R i g h t / L e f t S e l e c t s t a r t i n g m a z e

M e n u S e l e c t g a m e t y p e ( A o r B )

S e l e c t S t a r t t h e g a m e

I n g a m e

U p / D o w n /

L e f t / R i g h t

S t e e r t h e s n a k e

S e l e c t P a u s e a n d r e s u m e t h e g a m e

P o w e r Q u i t

I n g a m e A , t h e m a z e s t a y s t h e s a m e , i n g a m e B a f t e r a n i n c r e a s i n g n u m b e r o f a p p l e s

e a t e n t h e m a z e i s r e p l a c e d b y a n e w o n e .




C h a p t e r 1 0 . P l u g i n s 1 0 4

1 0 . 1 . 2 8 . S o k o b a n

F i g u r e 1 0 . 2 4 . : S o k o b a n

T h e o b j e c t o f t h e g a m e i s t o p u s h b o x e s i n t o t h e i r c o r r e c t p o s i t i o n i n a c r o w d e d w a r e h o u s e

w i t h a m i n i m a l n u m b e r o f p u s h e s a n d m o v e s . T h e b o x e s c a n o n l y b e p u s h e d , n e v e r p u l l e d ,

a n d o n l y o n e c a n b e p u s h e d a t a t i m e .

S o k o b a n m a y b e u s e d a s a v i e w e r f o r v i e w i n g s a v e d s o l u t i o n s a n d p l a y i n g e x t e r n a l

l e v e l s e t s w i t h t h e . s o k e x t e n s i o n . L e v e l s e t s s h o u l d b e i n t h e s t a n d a r d S o k o b a n t e x t

f o r m a t o r R L E ( R u n L e n g t h E n c o d e d ) . F o r m o r e i n f o r m a t i o n a b o u t t h e l e v e l f o r m a t ,

s e e h t t p : / / s o k o b a n o . d e / w i k i / i n d e x . p h p ? t i t l e = L e v e l _ f o r m a t


http://sokobano.de/wiki/index.php?title=Level_format



C h a p t e r 1 0 . P l u g i n s 1 0 5


I n g a m e

U p , D o w n ,

L e f t , R i g h t

M o v e t h e s o k o b a n u p , d o w n , l e f t , o r

r i g h t

P o w e r M e n u

V o l u m e d o w n B a c k t o p r e v i o u s l e v e l

M e n u R e s t a r t l e v e l

V o l u m e u p G o t o n e x t l e v e l

S e l e c t U n d o l a s t m o v e m e n t

A R e d o p r e v i o u s l y u n d o n e m o v e

S o l u t i o n p l a y b a c k

S e l e c t P a u s e / r e s u m e

U p / D o w n I n c r e a s e / d e c r e a s e p l a y b a c k s p e e d

L e f t / R i g h t G o b a c k w a r d / f o r w a r d ( w h i l e p a u s e d )

P o w e r Q u i t

S o m e p l a c e s w h e r e c a n y o u c a n n d l e v e l s e t s :

• h t t p : / / w w w . s o u r c e c o d e . s e / s o k o b a n / l e v e l s . p h p

• h t t p : / / s o k o b a n o . d e / e n / l e v e l s . p h p

N o t e t h a t s o m e l e v e l s e t s m a y c o n t a i n l e v e l s t h a t a r e t o o l a r g e f o r t h i s v e r s i o n o f S o k o b a n

a n d a r e u n p l a y a b l e a s a r e s u l t .


http://sokobano.de/en/levels.php

http://www.sourcecode.se/sokoban/levels.php



C h a p t e r 1 0 . P l u g i n s 1 0 6

1 0 . 1 . 2 9 . S o l i t a i r e

F i g u r e 1 0 . 2 5 . : K l o n d i k e s o l i t a i r e

T h i s i s t h e c l a s s i c K l o n d i k e s o l i t a i r e g a m e f o r R o c k b o x . T h i s i s p r o b a b l y t h e b e s t - k n o w n

s o l i t a i r e i n t h e w o r l d . M a n y p e o p l e d o n o t e v e n r e a l i z e t h a t o t h e r g a m e s e x i s t . T h o u g h

t h e n a m e m a y n o t b e f a m i l i a r , t h e g a m e i t s e l f c e r t a i n l y i s . T h i s i s d u e i n n o s m a l l p a r t

t o M i c r o s o f t ' s i n c l u s i o n o f t h e t h e g a m e i n e v e r y v e r s i o n o f W i n d o w s . T h o u g h p o p u l a r ,

t h e o d d s o f w i n n i n g a r e r a t h e r l o w , p e r h a p s o n e i n t h i r t y h a n d s .

F o r t h e f u l l s e t o f r u l e s t o t h e g a m e , a n d o t h e r i n t e r e s t i n g i n f o r m a t i o n v i s i t h t t p :

/ / w w w . s o l i t a i r e c e n t r a l . c o m / r u l e s / k l o n d i k e . h t m l


http://www.solitairecentral.com/rules/klondike.html

http://www.solitairecentral.com/rules/klondike.html



C h a p t e r 1 0 . P l u g i n s 1 0 7


U p / D o w n /

L e f t / R i g h t

M o v e C u r s o r a r o u n d .

S e l e c t S e l e c t c a r d s , m o v e c a r d s , r e v e a l h i d d e n

c a r d s . . .

M e n u I f a c a r d w a s s e l e c t e d u n s e l e c t i t , e l s e

D r a w 3 n e w c a r d s f r o m t h e r e m a i n s s t a c k

A + L e f t P u t t h e c a r d f r o m t h e t o p o f t h e r e m a i n s

s t a c k o n t o p o f t h e c u r s o r

L o n g S e l e c t P u t t h e c a r d u n d e r t h e c u r s o r o n o n e o f

t h e 4 n a l c o l o u r s t a c k s .

A + R i g h t P u t t h e c a r d o n t o p o f t h e r e m a i n s s t a c k

o n o n e o f t h e n a l c o l o u r s t a c k s .

P o w e r S h o w m e n u

1 0 . 1 . 3 0 . S p a c e r o c k s

F i g u r e 1 0 . 2 6 . : S p a c e r o c k s

S p a c e r o c k s i s a c l o n e o f t h e o l d a r c a d e g a m e A s t e r o i d s . T h e g o a l o f t h e g a m e i s t o b l o w

u p t h e a s t e r o i d s a n d a v o i d b e i n g h i t b y t h e m . O n c e i n a w h i l e , a U F O w i l l a p p e a r

s h o o t t h i s f o r e x t r a p o i n t s .




C h a p t e r 1 0 . P l u g i n s 1 0 8


S e l e c t S h o o t

U p T h r u s t

L e f t / R i g h t T u r n l e f t / r i g h t

D o w n T e l e p o r t

A P a u s e g a m e

P o w e r Q u i t

1 0 . 1 . 3 1 . S t a r

F i g u r e 1 0 . 2 7 . : S t a r g a m e

T h i s i s a p u z z l e g a m e . I t i s a c t u a l l y a r e w r i t e o f S t a r , a g a m e w r i t t e n b y C D K d e s i g n e d

f o r t h e h p 4 8 c a l c u l a t o r .

R u l e s : T a k e a l l o f t h e o s t o g o t o t h e n e x t l e v e l . Y o u c a n s w i t c h c o n t r o l b e t w e e n t h e

l l e d c i r c l e , w h i c h c a n t a k e o s , a n d t h e l l e d s q u a r e , w h i c h i s u s e d a s a m o b i l e w a l l t o

a l l o w y o u r l l e d c i r c l e t o g e t t o p l a c e s o n t h e s c r e e n i t c o u l d n o t o t h e r w i s e r e a c h . T h e

b l o c k c a n n o t t a k e o s .




C h a p t e r 1 0 . P l u g i n s 1 0 9


L e f t M o v e L e f t

R i g h t M o v e R i g h t

U p M o v e U p

D o w n M o v e D o w n

S e l e c t S w i t c h b e t w e e n c i r c l e a n d s q u a r e

V o l u m e d o w n P r e v i o u s l e v e l

A R e s e t l e v e l

V o l u m e u p N e x t l e v e l


1 0 . 1 . 3 2 . S u d o k u

F i g u r e 1 0 . 2 8 . : S u d o k u

S u d o k u i n R o c k b o x c a n a c t a s b o t h a p l u g i n a n d a v i e w e r . W h e n s t a r t i n g S u d o k u f r o m

t h e B r o w s e P l u g i n s m e n u , a r a n d o m g a m e w i l l b e g e n e r a t e d a u t o m a t i c a l l y , a n d a n

e s t i m a t e o f i t s d i c u l t y ( v e r y e a s y , e a s y , m e d i u m , h a r d o r e n d i s h ) w i l l b e d i s p l a y e d

o n t h e s c r e e n . N e w g a m e s c a n b e g e n e r a t e d f r o m t h e G e n e r a t e m e n u o p t i o n . W h e n

p l a y i n g a n e x i s t i n g S u d o k u g a m e l e f r o m R o c k b o x ' l e b r o w s e r t h e p l u g i n i s i n v o k e d

a s v i e w e r . T h e s e l e c t e d S u d o k u w i l l g e t l o a d e d a n d y o u c a n s t a r t s o l v i n g i t . T h e s u d o k u

g a m e s n e e d t o b e s t o r e d a s t e x t l e s w i t h t h e e x t e n s i o n . s s a s s i n g l e l e p e r g a m e .




C h a p t e r 1 0 . P l u g i n s 1 1 0

Y o u c a n c r e a t e a n d s a v e y o u r o w n g r i d s u n d e r t h e N e w m e n u o p t i o n . E n t e r t h e m e n u

( a s d e s c r i b e d i n t h e k e y t a b l e b e l o w ) w h e n y o u h a v e n i s h e d a n d e n t e r t h e f u l l p a t h t o

s a v e t o i n c l u d i n g t h e . s s e x t e n s i o n ( e . g . / s u d o k u / n e w . s s ) .

T h e s c r a t c h p a d

W h e n y o u p l a y S u d o k u o n p a p e r m o s t p e o p l e l i k e t o m a r k n u m b e r s i n c e l l s t h a t a r e

p o s s i b l e c a n d i d a t e s f o r t h e c e l l s . T h i s c a n b e d o n e w i t h t h e s c r a t c h p a d , s h o w n a s s e p a r a t e

c o l u m n . C h a n g e t h e n u m b e r u n d e r t h e c u r s o r t o t h e n u m b e r y o u w a n t t o p u t o n t h e

s c r a t c h p a d a n d p r e s s t h e s c r a t c h p a d b u t t o n , t h e n u m b e r w i l l t h e n b e a d d e d . I f t h e

n u m b e r w a s a l r e a d y o n t h e s c r a t c h p a d i t w i l l g e t r e m o v e d a g a i n . T h e c o l u m n i s s t o r e d

s e p e r a t l y f o r e v e r y c e l l o n t h e b o a r d . T h e s t o r e d v a l u e s c a n b e d i s p l a y e d i n l i n e a s s m a l l

d o t s b y e n a b l i n g t h e S h o w M a r k i n g s s e t t i n g s .

N o t e : T h e s c r a t c h p a d i s n o t s a v e d w h e n s a v i n g t h e g a m e . b


U p / D o w n /

L e f t / R i g h t

M o v e t h e c u r s o r

S e l e c t C h a n g e n u m b e r u n d e r t h e c u r s o r

L o n g S e l e c t C o n s t a n t l y c h a n g i n g t h e n u m b e r u n d e r

t h e c u r s o r

M e n u O p e n M e n u

A A d d / R e m o v e n u m b e r t o s c r a t c h p a d

P o w e r Q u i t

S o m e p l a c e s w h e r e c a n y o u c a n n d . s s l e s :

• S i m p l e S u d o k u ( A d v a n c e d P u z z l e P a c k s 1 a n d 2 l o c a t e d n e a r t h e b o t t o m o f t h a t

p a g e ) : h t t p : / / w w w . a n g u s j . c o m / s u d o k u /

• K j e l l ' s S u d o k u g e n e r a t o r / s o l v e r : h t t p : / / k j e l l . h a x x . s e / s u d o k u /


http://kjell.haxx.se/sudoku/

http://www.angusj.com/sudoku/



C h a p t e r 1 0 . P l u g i n s 1 1 1

1 0 . 1 . 3 3 . W o r m l e t

F i g u r e 1 0 . 2 9 . : W o r m l e t g a m e

W o r m l e t i s a m u l t i - w o r m g a m e o n a m u l t i - t h r e a d e d m u l t i - f u n c t i o n a l R o c k b o x c o n s o l e .

Y o u n a v i g a t e a h u n g r y l i t t l e w o r m . H e l p y o u r w o r m t o n d f o o d a n d t o a v o i d p o i s o n e d

a r g h - t i l e s . T h e g o a l i s t o t u r n y o u r t i n y w o r m i n t o a b i g w o r m f o r a s l o n g a s p o s s i b l e .

G a m e c o n t r o l s :


L e f t T u r n l e f t

R i g h t T u r n r i g h t

U p T u r n U p

D o w n T u r n D o w n

T h e g a m e

U s e t h e c o n t r o l k e y s o f y o u r w o r m t o n a v i g a t e a r o u n d o b s t a c l e s a n d n d f o o d . W o r m s

d o n o t s t o p m o v i n g e x c e p t w h e n d e a d . D e a d w o r m s a r e n o f u n . B e c a r e f u l a s y o u r w o r m

w i l l t r y t o e a t a n y t h i n g t h a t y o u s t e e r i t a c r o s s . I t w o n ' t d i s t i n g u i s h w h e t h e r i t i s e d i b l e

o r n o t .




C h a p t e r 1 0 . P l u g i n s 1 1 2

F o o d . T h e s m a l l s q u a r e h o l l o w p i e c e s a r e f o o d . M o v e t h e w o r m o v e r a f o o d t i l e t o e a t

i t . A f t e r e a t i n g t h e w o r m g r o w s . E a c h t i m e a p i e c e o f f o o d h a s b e e n e a t e n a n e w

p i e c e o f f o o d w i l l p o p u p s o m e w h e r e . U n f o r t u n a t e l y f o r e a c h n e w p i e c e o f f o o d t h a t

a p p e a r s t w o n e w a r g h p i e c e s w i l l a p p e a r , t o o .

A r g h . A n a r g h i s a b l a c k s q u a r e p o i s o n e d p i e c e - s l i g h t l y b i g g e r t h a n f o o d - t h a t m a k e s

a w o r m s a y A r g h ! w h e n r u n i n t o . A w o r m t h a t e a t s a n a r g h i s d e a d . T h u s e a t i n g

a n a r g h m u s t b e a v o i d e d u n d e r a n y c i r c u m s t a n c e s . A r g h s h a v e t h e a n n o y i n g

t e n d e n c y t o a c c u m u l a t e .

W o r m s . T h o u s h a l l n o t e a t w o r m s . N e i t h e r o t h e r w o r m s n o r t h y s e l f . E a t i n g w o r m s i s

b l a s p h e m o u s c a n n i b a l i s m , n o t h e a l t h y a n d c a u s e s i n s t a n t d e a t h . A n d i t d o e s n ' t

h e l p a n y w a y : t h e o t h e r w o r m i s n ' t h u r t b y t h e b i t e . I t w i l l g o o n c r e e p i n g h a p p i l y

a n d e a t a l l t h e f o o d y o u l e f t o n t h e t a b l e .

W a l l s . D o n ' t c r a s h i n t o t h e w a l l s . W a l l s a r e n o t e d i b l e . C r a s h i n g a w o r m a g a i n s t a w a l l

c a u s e s i t a h e a d a c h e i t d o e s n ' t s u r v i v e .

G a m e o v e r . T h e g a m e i s o v e r w h e n a l l w o r m s a r e d e a d . T h e l o n g e s t w o r m w i n s t h e

g a m e .

P a u s e t h e g a m e . P r e s s S e l e c t t o p a u s e t h e g a m e . P r e s s i t a g a i n t o r e s u m e t h e g a m e .

S t o p t h e g a m e . T h e r e a r e t w o w a y s t o s t o p a r u n n i n g g a m e .

• I f y o u w a n t t o q u i t W o r m l e t e n t i r e l y s i m p l y h i t P o w e r . T h e g a m e w i l l s t o p

i m m e d i a t e l y a n d y o u w i l l r e t u r n t o t h e g a m e m e n u .

• I f y o u w a n t t o s t o p t h e g a m e a n d s t i l l s e e t h e s c r e e n h i t A . T h i s f r e e z e s t h e

g a m e . I f y o u h i t A b u t t o n a g a i n a n e w g a m e s t a r t s w i t h t h e s a m e c o n g u r a -

t i o n . T o r e t u r n t o t h e g a m e s m e n u y o u c a n h i t P o w e r . A s t o p p e d g a m e c a n

n o t b e r e s u m e d .

T h e s c o r e b o a r d

O n t h e r i g h t s i d e o f t h e g a m e e l d i s t h e s c o r e b o a r d . F o r e a c h w o r m i t d i s p l a y s i t s s t a t u s

a n d i t s l e n g t h . T h e t o p m o s t e n t r y d i s p l a y s t h e s t a t e o f w o r m 1 , t h e s e c o n d w o r m 2 a n d

t h e t h i r d w o r m 3 . W h e n a w o r m d i e s i t s e n t r y o n t h e s c o r e b o a r d t u r n s b l a c k .

L e n : H e r e t h e c u r r e n t l e n g t h o f t h e w o r m i s d i s p l a y e d . W h e n a w o r m i s e a t i n g f o o d i t

g r o w s b y o n e p i x e l f o r e a c h s t e p i t m o v e s .

H u n g r y : T h a t ' s t h e n o r m a l s t a t e o f a w o r m . W o r m s a r e a l w a y s h u n g r y a n d w a n t t o e a t .

I t i s g o o d t o h a v e a h u n g r y w o r m s i n c e i t m e a n s t h a t y o u r w o r m i s a l i v e . B u t i t i s

b e t t e r t o g e t y o u r w o r m g r o w i n g .

G r o w i n g : W h e n a w o r m h a s e a t e n a p i e c e o f f o o d i t s t a r t s g r o w i n g . F o r e a c h s t e p i t

m o v e s o v e r f o o d i t c a n g r o w b y o n e p i x e l . O n e p i e c e o f f o o d l a s t s f o r 7 s t e p s . A f t e r




C h a p t e r 1 0 . P l u g i n s 1 1 3

y o u r w o r m h a s m o v e d 7 s t e p s t h e f o o d i s u s e d u p . I f a n o t h e r p i e c e o f f o o d i s e a t e n

w h i l e g r o w i n g i t w i l l i n c r e a s e t h e s i z e o f t h e w o r m f o r a n o t h e r 7 s t e p s .

C r a s h e d : T h i s i n d i c a t e s t h a t a w o r m h a s c r a s h e d a g a i n s t a w a l l .

A r g h : I f t h e s c o r e b o a r d e n t r y d i s p l a y s A r g h ! i t m e a n s t h e w o r m i s d e a d b e c a u s e i t

t r i e d t o e a t a n a r g h . U n t i l w e c a n m a k e t h e w o r m s a y A r g h ! i t i s y o u r j o b t o

s a y A r g h ! a l o u d .

W o r m e d : T h e w o r m t r i e d t o e a t a n o t h e r w o r m o r e v e n i t s e l f . T h a t ' s w h y i t i s d e a d n o w .

M a k i n g t r a p s f o r o t h e r p l a y e r s w i t h a w o r m i s a g o o d w a y t o g e t t h e m o u t o f t h e

g a m e .

H i n t s

• I n i t i a l l y y o u w i l l b e b u s y w i t h c o n t r o l l i n g y o u r w o r m . T r y t o a v o i d o t h e r w o r m s

a n d c r a w l f a r a w a y f r o m t h e m . W a i t u n t i l t h e y c u r l u p t h e m s e l v e s a n d c o l l e c t t h e

f o o d a f t e r w a r d s . D o n ' t w o r r y i f t h e o t h e r w o r m s g r o w l o n g e r t h a n y o u r s - y o u c a n

c a t c h u p a f t e r t h e y ' v e d i e d .

• W h e n y o u a r e m o r e e x p e r i e n c e d w a t c h t h e t a c t i c s o f o t h e r w o r m s . T h o s e w o r m s

c o n t r o l l e d b y a r t i c i a l s t u p i d i t y h e a d s t r a i g h t f o r t h e n e a r e s t p i e c e o f f o o d . L e t t h e

o t h e r w o r m h a v e i t s n e x t p i e c e o f f o o d a n d h e a d f o r t h e f o o d i t w o u l d p r o b a b l y

w a n t n e x t . T r y t o p u t y o u r s e l f b e t w e e n t h e o p p o n e n t a n d t h a t f o o d . F r o m n o w

o n y o u c a n ` c o n t r o l ' t h e o t h e r w o r m b y b l o c k i n g i t . Y o u c o u l d t r a p i t b y m a k i n g

a 1 p i x e l w i d e U - t u r n . Y o u a l s o c o u l d m o v e f r o m f o o d t o f o o d a n d m a k e s u r e y o u

k e e p b e t w e e n y o u r o p p o n e n t a n d t h e f o o d . S o y o u c a n a l w a y s r e a c h i t b e f o r e y o u r

o p p o n e n t .




C h a p t e r 1 0 . P l u g i n s 1 1 4

1 0 . 1 . 3 4 . X o b o x

F i g u r e 1 0 . 3 0 . : X o b o x

X o b o x i s a s i m p l e c l o n e o f t h e w e l l k n o w n a r c a d e g a m e Q i x . T h e a i m o f t h e g a m e i s t o

s e c t i o n o p a r t s o f t h e a r e n a w i t h y o u r t r a i l i n o r d e r t o r e m o v e t h a t s e c t i o n f r o m t h e

g a m e . B e c a r e f u l n o t t o g e t i n t h e w a y o f e n e m y b a l l s b e c a u s e , i f t h e y h i t y o u o r y o u r

t r a i l , y o u l o s e a l i f e . T o n i s h a l e v e l y o u h a v e t o s e c t i o n o m o r e t h a n 7 5 % .


U p , D o w n ,

L e f t , R i g h t

M o v e a r o u n d t h e a r e n a

A P a u s e

P o w e r O p e n m e n u




C h a p t e r 1 0 . P l u g i n s 1 1 5

1 0 . 2 . D e m o s

1 0 . 2 . 1 . B o u n c e

F i g u r e 1 0 . 3 1 . : B o u n c e

T h i s d e m o i s o f t h e w o r d R o c k b o x b o u n c i n g a c r o s s t h e s c r e e n . T h e r e i s a l s o a n a n a l o g u e

c l o c k i n t h e b a c k g r o u n d . I n S c r o l l m o d e t h e b o u n c i n g t e x t i s r e p l a c e d b y a d i e r e n t

o n e s c r o l l i n g f r o m r i g h t t o l e f t .


U p / D o w n M o v e s t o n e x t / p r e v i o u s o p t i o n

R i g h t / L e f t I n c r e a s e s / d e c r e a s e s o p t i o n v a l u e

A T o g g l e s S c r o l l m o d e

P o w e r E x i t s b o u n c e d e m o

A v a i l a b l e o p t i o n s a r e :

X d i s t / Y d i s t . T h e d i s t a n c e t o X a x i s a n d Y a x i s r e s p e c t i v e l y

X a d d / Y a d d . H o w f a s t t h e c o d e m o v e s o n t h e s i n e c u r v e o n e a c h a x i s

X s a n e / Y s a n e . C h a n g e s t h e a p p e a r a n c e o f t h e b o u n c i n g .




C h a p t e r 1 0 . P l u g i n s 1 1 6

1 0 . 2 . 2 . C r e d i t s

T h e c r e d i t s p l u g i n s c r o l l s t h e e n t i r e l i s t o f t h e n a m e s o f a l l t h e R o c k b o x c o n t r i b u t o r s a f t e r

d i s p l a y i n g t h e R o c k b o x l o g o a n d v e r s i o n . T h i s p l u g i n i s c a l l e d w h e n s e l e c t i n g V e r s i o n

f r o m t h e S y s t e m s e c t i o n o f t h e R o c k b o x m a i n m e n u . E x i t a t a n y t i m e b y p r e s s i n g L e f t

o r P o w e r .

1 0 . 2 . 3 . C u b e

F i g u r e 1 0 . 3 2 . : C u b e

T h i s i s a r o t a t i n g c u b e s c r e e n s a v e r i n 3 D .


A D i s p l a y a t m a x i m u m f r a m e r a t e

S e l e c t P a u s e

M e n u C y c l e d r a w m o d e

R i g h t / L e f t S e l e c t a x i s t o a d j u s t

U p / D o w n C h a n g e s p e e d / a n g l e ( s p e e d c a n n o t b e

c h a n g e d w h i l e p a u s e d )

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 1 7

1 0 . 2 . 4 . D e m y s t i f y

F i g u r e 1 0 . 3 3 . : D e m y s t i f y

D e m y s t i f y i s a s c r e e n s a v e r l i k e d e m o .



/ V o l u m e U p

I n c r e a s e / d e c r e a s e s p e e d


R e w i n d

A d d / r e m o v e p o l y g o n

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 1 8

1 0 . 2 . 5 . F i r e

F i g u r e 1 0 . 3 4 . : F i r e

F i r e i s a d e m o d i s p l a y i n g a r e e e c t .



R e w i n d

I n c r e a s e / d e c r e a s e n u m b e r o f a m e s

L e f t V o l u m e D o w n T o g g l e a m e t y p e

R i g h t V o l u m e U p T o g g l e m o v i n g a m e s

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 1 9

1 0 . 2 . 6 . F r a c t a l s

F i g u r e 1 0 . 3 5 . : F r a c t a l s : M a n d e l b r o t s e t

T h i s d e m o n s t r a t i o n d r a w s f r a c t a l i m a g e s f r o m t h e M a n d e l b r o t s e t .


D i r e c t i o n k e y s M o v e a b o u t t h e i m a g e

S e l e c t Z o o m i n

L o n g S e l e c t Z o o m o u t

V o l u m e d o w n D e c r e a s e i t e r a t i o n d e p t h ( l e s s d e t a i l )

V o l u m e u p I n c r e a s e i t e r a t i o n d e p t h ( m o r e d e t a i l )

A R e s e t a n d r e t u r n t o t h e d e f a u l t i m a g e

P o w e r Q u i t

1 0 . 2 . 7 . L o g o

D e m o s h o w i n g t h e R o c k b o x l o g o b o u n c i n g a r o u n d t h e s c r e e n .


R i g h t / L e f t I n c r e a s e / d e c r e a s e s p e e d o n t h e x - a x i s

U p / D o w n I n c r e a s e / d e c r e a s e s p e e d o n t h e y - a x i s

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 2 0

1 0 . 2 . 8 . M o s a i q u e

F i g u r e 1 0 . 3 6 . : M o s a i q u e

T h i s s i m p l e g r a p h i c s d e m o d r a w s a m o s a i c p i c t u r e o n t h e s c r e e n o f t h e p l a y e r . P r e s s

P o w e r t o q u i t .




C h a p t e r 1 0 . P l u g i n s 1 2 1

1 0 . 2 . 9 . O s c i l l o s c o p e

F i g u r e 1 0 . 3 7 . : O s c i l l o s c o p e

T h i s d e m o s h o w s t h e s h a p e o f t h e s o u n d s a m p l e s t h a t m a k e u p t h e m u s i c b e i n g p l a y e d .

A t f a s t e r s p e e d r a t e s , t h e p l a y e r i s l e s s r e s p o n s i v e t o u s e r i n p u t a n d m u s i c m a y s t a r t t o

s k i p .

K e y s


S e l e c t T o g g l e l l e d / c u r v e / p l o t

D o w n T o g g l e w h e t h e r t o s c r o l l o r n o t

U p T o g g l e d r a w i n g o r i e n t a t i o n

A P a u s e t h e d e m o

V o l u m e u p /

V o l u m e d o w n

I n c r e a s e / d e c r e a s e v o l u m e

R i g h t / L e f t I n c r e a s e / d e c r e a s e s p e e d

P o w e r E x i t d e m o




C h a p t e r 1 0 . P l u g i n s 1 2 2

1 0 . 2 . 1 0 . P i c t u r e F l o w

F i g u r e 1 0 . 3 8 . : P i c t u r e F l o w

P i c t u r e F l o w p r o v i d e s a v i s u a l i s a t i o n o f y o u r a l b u m s w i t h t h e i r a s s o c i a t e d c o v e r a r t . I t i s

p o s s i b l e t o s t a r t p l a y b a c k o f t h e s e l e c t e d a l b u m f r o m P i c t u r e F l o w . P l a y b a c k w i l l s t a r t

f r o m t h e s e l e c t e d t r a c k . T h e P i c t u r e F l o w p l u g i n w i l l c o n t i n u e t o r u n w h i l e y o u r t r a c k s

a r e p l a y e d .

R e q u i r e m e n t s

P i c t u r e F l o w u s e s b o t h t h e a l b u m a r t ( s e e s e c t i o n B . 2 1 ( p a g e 1 9 3 ) ) a n d d a t a b a s e ( s e e

s e c t i o n 4 . 2 ( p a g e 2 7 ) ) f e a t u r e s o f R o c k b o x . I t i s t h e r e f o r e i m p o r t a n t t h a t t h e s e a r e

w o r k i n g c o r r e c t l y b e f o r e a t t e m p t i n g t o u s e P i c t u r e F l o w . I n a d d i t i o n , t h e r e a r e s o m e

o t h e r p o i n t s o f w h i c h t o b e a w a r e :

• P i c t u r e F l o w w i l l a c c e p t a l b u m a r t l a r g e r t h a n t h e d i m e n s i o n s o f t h e s c r e e n , b u t

t h e l a r g e r t h e d i m e n s i o n s , t h e l o n g e r t h e y w i l l t a k e t o s c a l e .




C h a p t e r 1 0 . P l u g i n s 1 2 3

K e y s


L e f t / R i g h t V o l u m e U p /

V o l u m e D o w n

S c r o l l t h r o u g h a l b u m s


V o l u m e D o w n

S c r o l l t h r o u g h t r a c k l i s t

S e l e c t F o r w a r d E n t e r t r a c k l i s t / P l a y a l b u m f r o m s e -

l e c t e d t r a c k

L e f t R e w i n d E x i t t r a c k l i s t

M e n u M e n u E n t e r m e n u

P o w e r R e w i n d E x i t P i c t u r e F l o w

M a i n M e n u

G o t o W P S . L e a v e P i c t u r e F l o w a n d e n t e r t h e w h i l e p l a y i n g s c r e e n .

P l a y b a c k C o n t r o l . C o n t r o l m u s i c p l a y b a c k f r o m w i t h i n t h e p l u g i n .

S e t t i n g s . E n t e r t h e s e t t i n g s m e n u .

R e t u r n . E x i t m e n u .

Q u i t . E x i t P i c t u r e F l o w p l u g i n .

S e t t i n g s M e n u

S h o w F P S . D i s p l a y s f r a m e s p e r s e c o n d o n s c r e e n .

S p a c i n g . T h e d i s t a n c e b e t w e e n t h e f r o n t e d g e s o f t h e s i d e s l i d e s , i . e . c h a n g e s t h e d e g r e e

o f o v e r l a p o f t h e s i d e s l i d e s . A l a r g e r n u m b e r m e a n s l e s s o v e r l a p . S c a l e s w i t h z o o m .

C e n t r e m a r g i n . T h e d i s t a n c e , i n s c r e e n p i x e l s , w i t h z o o m a t 1 0 0 , b e t w e e n t h e c e n t r e

a n d s i d e s l i d e s . S c a l e s w i t h z o o m .

N u m b e r o f s l i d e s . S e t s t h e n u m b e r o f s l i d e s a t e a c h s i d e , i n c l u d i n g t h e c e n t r e s l i d e .

T h e r e f o r e i f s e t t o 4 , t h e r e w i l l b e 3 s l i d e s o n t h e l e f t , t h e c e n t r e s l i d e , a n d t h e n 3

s l i d e s o n t h e r i g h t .

Z o o m . C h a n g e s t h e d i s t a n c e a t w h i c h s l i d e s a r e r e n d e r e d f r o m t h e c a m e r a .

S h o w a l b u m t i t l e . A l l o w s s e t t i n g t h e a l b u m t i t l e t o b e s h o w n a b o v e o r b e l o w t h e c o v e r

a r t , o r n o t a t a l l .

R e s i z e C o v e r s . S e t w h e t h e r t o a u t o m a t i c a l l y r e s i z e t h e c o v e r s o r t o l e a v e t h e m a t t h e i r

o r i g i n a l s i z e .




C h a p t e r 1 0 . P l u g i n s 1 2 4

R e b u i l d c a c h e . R e b u i l d t h e P i c t u r e F l o w c a c h e . T h i s i s n e e d e d i n o r d e r f o r P i c t u r e F l o w

t o p i c k u p n e w a l b u m s , a n d m a y o c c a s i o n a l l y b e n e e d e d i f a l b u m s a r e r e m o v e d .

1 0 . 2 . 1 1 . P l a s m a

F i g u r e 1 0 . 3 9 . : P l a s m a

P l a s m a i s a d e m o d i s p l a y i n g a 8 0 ' s s t y l e r e t r o p l a s m a e e c t .



R e w i n d

I n c r e a s e / d e c r e a s e F r e q u e n c y

S e l e c t C h a n g e C o l o r

P o w e r / L o n g

P o w e r

E x i t




C h a p t e r 1 0 . P l u g i n s 1 2 5

1 0 . 2 . 1 2 . S n o w

F i g u r e 1 0 . 4 0 . : H a v e y o u e v e r s e e n s n o w f a l l i n g ?

T h i s d e m o r e p l i c a t e s s n o w f a l l i n g o n y o u r s c r e e n . I f y o u l o v e w i n t e r , y o u w i l l l o v e t h i s

d e m o . O r m a y b e n o t . P r e s s P o w e r t o q u i t .




C h a p t e r 1 0 . P l u g i n s 1 2 6

1 0 . 2 . 1 3 . S t a r e l d

F i g u r e 1 0 . 4 1 . : S t a r e l d

S t a r e l d s i m u l a t i o n ( l i k e t h e c l a s s i c s c r e e n s a v e r ) .


R i g h t / L e f t I n c r e a s e / d e c r e a s e n u m b e r o f s t a r s

U p / D o w n I n c r e a s e / d e c r e a s e s p e e d

S e l e c t C h a n g e c o l o u r s

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 2 7

1 0 . 2 . 1 4 . V U m e t e r

F i g u r e 1 0 . 4 2 . : V U - M e t e r

T h i s i s a V U m e t e r , w h i c h d i s p l a y s t h e v o l u m e o f t h e l e f t a n d r i g h t a u d i o c h a n n e l s . T h e r e

a r e 3 t y p e s o f m e t e r s e l e c t a b l e . T h e a n a l o g u e m e t e r i s a c l a s s i c n e e d l e s t y l e . T h e d i g i t a l

m e t e r i s m o d e l l e d a f t e r L E D v o l u m e d i s p l a y s , a n d t h e m i n i - m e t e r o p t i o n a l l o w s f o r t h e

d i s p l a y o f s m a l l m e t e r s i n a d d i t i o n t o t h e m a i n d i s p l a y ( a s a b o v e ) . F r o m t h e s e t t i n g s

m e n u t h e d e c a y t i m e f o r t h e m e t e r ( i t s m e m o r y ) , t h e m e t e r t y p e a n d t h e m e t e r s c a l e c a n

b e c h a n g e d .


P o w e r S a v e s e t t i n g s a n d q u i t

A H e l p

M e n u S e t t i n g s

U p R a i s e V o l u m e

D o w n L o w e r V o l u m e

1 0 . 3 . V i e w e r s

V i e w e r s a r e p l u g i n s w h i c h a r e a s s o c i a t e d w i t h s p e c i c l e e x t e n s i o n s . T h e y c a n n o t b e

r u n d i r e c t l y b u t a r e s t a r t e d b y p l a y i n g t h e a s s o c i a t e d l e . V i e w e r s a r e s t o r e d i n t h e

/ . r o c k b o x / r o c k s / v i e w e r s / d i r e c t o r y .




C h a p t e r 1 0 . P l u g i n s 1 2 8

N o t e : S o m e v i e w e r p l u g i n s c a n o n l y b e u s e d b y s e l e c t i n g t h e O p e n W i t h . . . o p t i o n bf r o m t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) .

V i e w e r P l u g i n A s s o c i a t e d l e t y p e ( s ) C o n t e x t M e n u o n l y

S h o r t c u t s . l i n k

C h i p - 8 E m u l a -

t o r

. c h 8

F r o t z . z 1 - . z 8

I m a g e V i e w e r . b m p , . j p g , . j p e g , . p n g , . p p m

L u a s c r i p t i n g

l a n g u a g e

. l u a

M i d i p l a y . m i d , . m i d i

M P E G P l a y e r . m p g , . m p e g , . m p v , . m 2 v

M P 3 E n c o d e r . w a v x

R o c k b o y . g b , . g b c

S e a r c h . m 3 u , . m 3 u 8 x

S o r t . * x

T e x t V i e w e r . t x t , . n f o , . *

V B R x . m p 3 x

Z X B o x . t a p , . t a x , . s n a , . z 8 0

S h o p p i n g l i s t . s h o p p e r

1 0 . 3 . 1 . S h o r t c u t s

T h e S h o r t c u t s P l u g i n a l l o w s y o u t o j u m p t o p l a c e s w i t h i n t h e l e b r o w s e r w i t h o u t h a v i n g

t o n a v i g a t e t h e r e m a n u a l l y . T h e p l u g i n w o r k s w i t h . l i n k l e s . A . l i n k l e i s j u s t a

t e x t l e w i t h e v e r y l i n e c o n t a i n i n g t h e n a m e o f t h e l e o r t h e d i r e c t o r y y o u w a n t t o

q u i c k l y j u m p t o . A l l n a m e s s h o u l d b e f u l l a b s o l u t e n a m e s , i . e . t h e y s h o u l d s t a r t w i t h a

/ . D i r e c t o r y n a m e s s h o u l d a l s o e n d w i t h a / .

H o w t o c r e a t e . l i n k l e s

Y o u c a n u s e y o u r f a v o u r i t e t e x t e d i t o r t o c r e a t e a . l i n k l e o n t h e P C a n t h e n c o p y

t h e l e t o t h e p l a y e r . O r y o u c a n u s e t h e c o n t e x t m e n u o n e i t h e r a l e o r a d i r e c t o r y i n

t h e l e b r o w s e r t r e e , a n d u s e t h e A d d t o s h o r t c u t s m e n u o p t i o n . T h i s w i l l a p p e n d a

l i n e w i t h t h e f u l l n a m e o f t h e l e o r t h e d i r e c t o r y t o t h e s h o r t c u t s . l i n k l e i n t h e r o o t

d i r e c t o r y o f t h e p l a y e r . ( T h e l e w i l l b e c r e a t e d i f i t d o e s n o t e x i s t y e t . ) Y o u c a n l a t e r

r e n a m e t h e a u t o m a t i c a l l y c r e a t e d s h o r t c u t s . l i n k l e o r m o v e i t t o a n o t h e r d i r e c t o r y i f

y o u w i s h . S u b s e q u e n t c a l l s o f t h e c o n t e x t m e n u w i l l c r e a t e i t a g a i n .




C h a p t e r 1 0 . P l u g i n s 1 2 9

H o w t o u s e . l i n k l e s , i . e . j u m p t o d e s i r e d p l a c e s

T o u s e a . l i n k l e j u s t p l a y i t f r o m t h e l e b r o w s e r . T h i s w i l l s h o w y o u a l i s t w i t h t h e

e n t r i e s i n t h e l e . S e l e c t i n g o n e o f t h e m w i l l t h e n e x i t t h e p l u g i n a n d l e a v e y o u w i t h i n

t h e d i r e c t o r y s e l e c t e d , o r w i t h t h e l e s e l e c t e d i n t h e l e b r o w s e r . Y o u c a n t h e n p l a y t h e

l e o r d o w i t h i t w h a t e v e r y o u w a n t . T h e l e w i l l n o t b e p l a y e d a u t o m a t i c a l l y .

I f t h e . l i n k l e c o n t a i n s o n l y o n e e n t r y n o l i s t w i l l b e s h o w n , y o u w i l l d i r e c t l y j u m p

t o t h a t l o c a t i o n . T h e l e s h o r t c u t s . l i n k i n t h e r o o t d i r e c t o r y i s a n e x c e p t i o n . A f t e r

p l a y i n g i t , t h e l i s t w i l l b e s h o w n e v e n i f t h e l e c o n t a i n s j u s t o n e e n t r y .

I f t h e l i s t y o u a r e s e e i n g i s f r o m s h o r t c u t s . l i n k i n t h e r o o t d i r e c t o r y , y o u c a n d e l e t e

t h e s e l e c t e d e n t r y b y p r e s s i n g M e n u . D e l e t i n g e n t r i e s f r o m o t h e r . l i n k l e s i s n o t

p o s s i b l e .

A d v a n c e d U s a g e

P l a c i n g t h e l i n e # D i s p l a y l a s t p a t h s e g m e n t s = n ( w h e r e n i s a n u m b e r ) i n t h e b e g i n n i n g

o f a . l i n k l e w i l l l e a v e j u s t t h e l a s t n s e g m e n t s o f t h e e n t r i e s w h e n t h e y a r e s h o w n . F o r

e x a m p l e , i f n i s c h o s e n t o b e 1 , t h e n t h e e n t r y / M y M u s i c / c o l l e c t i o n / s o n g . m p 3 w i l l b e

s h o w n a s s o n g . m p 3 . T h i s a l l o w s y o u t o h i d e c o m m o n p a t h p r e x e s .

Y o u c a n a l s o p r o v i d e a c u s t o m d i s p l a y n a m e f o r e a c h e n t r y i n d i v i d u a l l y . T o d o s o ,

a p p e n d a t a b u l a t o r c h a r a c t e r a f t e r t h e e n t r y ' s p a t h f o l l o w e d b y y o u r c u s t o m n a m e . T h a t

n a m e w i l l t h e n b e u s e d f o r s h o w i n g t h e e n t r y . F o r e x a m p l e :

E x a m p l e

/ M y M u s i c / c o l l e c t i o n / s o n g . m p 3 < T A B > M y f a v o u r i t e s o n g !

1 0 . 3 . 2 . C h i p - 8 E m u l a t o r

C h i p 8 i s a k i n d o f a s s e m b l y l a n g u a g e f o r a l o n g - g o n e a r c h i t e c t u r e . T h i s p l u g i n r u n s

g a m e s w r i t t e n u s i n g t h e c h i p 8 i n s t r u c t i o n s . T o s t a r t a g a m e o p e n a . c h 8 l e i n t h e F i l e

B r o w s e r

T h e r e a r e l o t s o f t i n y C h i p 8 g a m e s ( u s u a l l y o n l y a b o u t 2 5 6 b y t e s t o a c o u p l e o f K B )

w h i c h w e r e m a d e p o p u l a r b y t h e H P 4 8 c a l c u l a t o r ' s e m u l a t o r f o r t h e m . T h e o r i g i n a l C h i p 8

h a d 6 4 ×3 2 p i x e l g r a p h i c s , a n d t h e n e w s u p e r c h i p e m u l a t o r s u p p o r t s 1 2 8 ×6 4 g r a p h i c s .

T h e o n l y p r o b l e m i s t h a t t h e y a r e b a s e d o n a 4 ×4 k e y b o a r d , b u t s i n c e m o s t g a m e s d o

n o t u s e a l l o f t h e b u t t o n s , t h i s c a n e a s i l y b e w o r k e d a r o u n d .

T o d o t h i s , o n e m a y p u t a . c 8 k l e w i t h t h e s a m e n a m e a s t h e o r i g i n a l p r o g r a m w h i c h

c o n t a i n s n e w k e y m a p p i n g s ( f o r B L I N K Y . c h 8 , o n e w r i t e s a B L I N K Y . c 8 k l e ) . T h a t . c 8 k

l e c o n t a i n s 1 6 c h a r a c t e r s d e s c r i b i n g t h e m a p p i n g f r o m t h e C h i p 8 k e y b o a r d t o t h e d e f a u l t

k e y m a p p i n g ( t h a t w a y , s e v e r a l C h i p 8 k e y s c a n b e p r e s s e d u s i n g o n l y o n e R o c k b o x k e y ) .

F o r e x a m p l e , a l e c o n t a i n i n g t h e s i n g l e l i n e :

C o d e

0 1 2 2 4 5 8 4 6 9 A B C D E F




C h a p t e r 1 0 . P l u g i n s 1 3 0

w o u l d c o r r e s p o n d t o t h e f o l l o w i n g n o n - d e f a u l t m a p p i n g s :

3 → 2 , 6 → 8 , 7 →4 , 8 → 6 .

T h e d e f a u l t k e y m a p p i n g s a r e :

C h i p 8 O 0 1 2 3 4 5 6 7 8 9 A B C D E F

K

e

y

P

o

w

e

r

M

e

n

u

U

p

V

o

l

u

m

e

d

o

w

n

L

e

f

t

S

e

l

e

c

t

R

i

g

h

t

V

o

l

u

m

e

u

p

D

o

w

n

A

S o m e p l a c e s w h e r e c a n y o u c a n n d . c h 8 l e s :

•T h e P l u g i n C h i p 8 p a g e o n w w w . r o c k b o x . o r g h a s s e v e r a l a t t a c h e d :

ZP l u g i n C h i p 8

• C h e c k o u t t h e H P 4 8 c h i p g a m e s s e c t i o n : h t t p : / / w w w . h p c a l c . o r g / h p 4 8 / g a m e s / c h i p /

• P C e m u l a t o r b y t h e g u y w h o w r o t e t h e H P 4 8 e m u l a t o r : h t t p : / / w w w . p d c . k t h . s e /

~ l f o / c h i p 8 / C H I P 8 . h t m

• L i n k s t o o t h e r c h i p 8 e m u l a t o r s : h t t p : / / w w w . z o p h a r . n e t / c h i p 8 . h t m l

1 0 . 3 . 3 . F r o t z

F r o t z i s a Z - M a c h i n e i n t e r p r e t e r f o r p l a y i n g I n f o c o m ' s i n t e r a c t i v e c t i o n g a m e s , a n d

n e w e r g a m e s u s i n g t h e s a m e f o r m a t . T o s t a r t a g a m e o p e n a . z 1 - . z 8 l e i n t h e F i l e

B r o w s e r . M o s t m o d e r n g a m e s a r e i n t h e . z 5 o r . z 8 f o r m a t b u t t h e o l d e r f o r m a t s u s e d

b y I n f o c o m a r e s u p p o r t e d .

Z - M a c h i n e g a m e s a r e t e x t b a s e d a n d m o s t d e p e n d h e a v i l y o n t y p e d c o m m a n d s . T h e

v i r t u a l k e y b o a r d i s u s e d f o r t e x t e n t r y , b o t h f o r t y p i n g e n t i r e l i n e s a n d f o r t y p i n g s i n g l e

c h a r a c t e r s w h e n t h e g a m e r e q u i r e s s i n g l e c h a r a c t e r i n p u t .

S o u n d s , p i c t u r e s , c o l o u r a n d U n i c o d e a r e n o t c u r r e n t l y s u p p o r t e d , b u t t h e i n t e r p r e t e r

i n f o r m s t h e g a m e o f t h i s a n d a l m o s t a l l g a m e s w i l l a d a p t s o t h a t t h e y a r e s t i l l p l a y a b l e .

T h i s p o r t o f F r o t z a t t e m p t s t o b e c o m p l i a n t w i t h t h e Z - M a c h i n e S p e c i c a t i o n v e r s i o n

1 . 0 .

S o m e p l a c e s w h e r e y o u c a n n d Z - M a c h i n e g a m e s , a n d i n f o r m a t i o n a b o u t i n t e r a c t i v e

c t i o n :

• T h e I n t e r a c t i v e F i c t i o n A r c h i v e , w h e r e m a n y f r e e m o d e r n w o r k s c a n b e d o w n l o a d e d :

h t t p : / / w w w . i f a r c h i v e . o r g /

• T h e s p e c i c f o l d e r o n t h e i f - a r c h i v e c o n t a i n i n g Z - M a c h i n e g a m e s : h t t p : / / w w w .

i f a r c h i v e . o r g / i n d e x e s / i f - a r c h i v e X g a m e s X z c o d e . h t m l


http://www.ifarchive.org/indexes/if-archiveXgamesXzcode.html

http://www.ifarchive.org/indexes/if-archiveXgamesXzcode.html

http://www.ifarchive.org/

http://www.zophar.net/chip8.html

http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm

http://www.pdc.kth.se/~lfo/chip8/CHIP8.htm

http://www.hpcalc.org/hp48/games/chip/

http://www.rockbox.org/wiki/PluginChip8



C h a p t e r 1 0 . P l u g i n s 1 3 1

• T h e I n f o c o m h o m e p a g e , w i t h i n f o r m a t i o n a b o u t h o w t o g e t t h e c l a s s i c c o m m e r c i a l

I n f o c o m g a m e s : h t t p : / / w w w . c s d . u w o . c a / I n f o c o m /

• T h e F r o t z h o m e p a g e ( f o r t h e o r i g i n a l U n i x p o r t ) : h t t p : / / f r o t z . s o u r c e f o r g e . n e t /

• A B e g i n n e r ' s G u i d e t o P l a y i n g I n t e r a c t i v e F i c t i o n : h t t p : / / w w w . m i c r o h e a v e n . c o m /

I F G u i d e /


U p F o r w a r d D i s p l a y k e y b o a r d t o e n t e r t e x t

S e l e c t P r e s s e n t e r

P o w e r O p e n F r o t z m e n u ( n o t a v a i l a b l e a t

M O R E p r o m p t s )

L o n g P o w e r Q u i t

1 0 . 3 . 4 . I m a g e V i e w e r

T h i s p l u g i n o p e n s i m a g e l e s f r o m t h e F i l e B r o w s e r t o d i s p l a y t h e m . S u p p o r t e d

f o r m a t s a r e a s f o l l o w s .

F o r m a t F i l e - e x t e n s i o n ( s )

B M P . b m p

J P E G . j p g , . j p e , . j p e g

P N G . p n g

P P M . p p m

N o t e : W h e n a n a u d i o l e i s p l a y i n g t h e s i z e o f t h e i m a g e i s l i m i t e d a s t h e d e c o d i n g bp r o c e s s n e e d s t o s h a r e m e m o r y w i t h a u d i o t r a c k s . T o b e a b l e t o v i e w a b i g g e r l e y o u

m a y n e e d t o s t o p p l a y b a c k .


U p / D o w n /

L e f t / R i g h t

M o v e a r o u n d i n z o o m e d i n i m a g e

V o l u m e u p Z o o m i n

V o l u m e d o w n Z o o m o u t

A + R i g h t N e x t i m a g e i n d i r e c t o r y

A + L e f t P r e v i o u s i m a g e i n d i r e c t o r y

M e n u S h o w m e n u / A b o r t

P o w e r Q u i t t h e v i e w e r


http://www.microheaven.com/IFGuide/

http://www.microheaven.com/IFGuide/

http://frotz.sourceforge.net/

http://www.csd.uwo.ca/Infocom/



C h a p t e r 1 0 . P l u g i n s 1 3 2

T h e m e n u h a s t h e f o l l o w i n g e n t r i e s .

R e t u r n . R e t u r n s y o u t o t h e i m a g e

T o g g l e S l i d e s h o w M o d e . E n a b l e s o r d i s a b l e s t h e s l i d e s h o w m o d e .

C h a n g e S l i d e s h o w T i m e o u t . Y o u c a n s e t t h e t i m e o u t f o r t h e s l i d e s h o w b e t w e e n 1 s e c -

o n d a n d 2 0 s e c o n d s .

S h o w P l a y b a c k M e n u . F r o m t h e p l a y b a c k m e n u y o u c a n c o n t r o l t h e p l a y b a c k o f t h e

c u r r e n t l y l o a d e d p l a y l i s t a n d c h a n g e t h e v o l u m e o f y o u r p l a y e r .

D i s p l a y O p t i o n s . F r o m t h i s m e n u y o u c a n f o r c e t h e v i e w e r t o r e n d e r t h e i m a g e i n

g r e y s c a l e u s i n g t h e G r e y s c a l e o p t i o n o r s e t t h e m e t h o d o f d i t h e r i n g u s e d i n

t h e D i t h e r i n g s u b m e n u . T h e s e s e t t i n g s o n l y t a k e a e c t f o r J P E G i m a g e s .

Q u i t . Q u i t s t h e v i e w e r a n d r e t u r n s t o t h e F i l e B r o w s e r .

N o t e : P r o g r e s s i v e s c a n a n d o t h e r u n u s u a l J P E G l e s a r e n o t s u p p o r t e d , a n d w i l l r e s u l t bi n v a r i o u s u n s u p p o r t e d x x m e s s a g e s . P r o c e s s i n g c o u l d a l s o f a i l i f t h e i m a g e i s t o o b i g

t o d e c o d e w h i c h w i l l b e e x p l a i n e d b y a r e s p e c t i v e m e s s a g e .

S u p p o r t e d P P M l e s a r e b o t h A S C I I P P M ( P 3 ) a n d r a w P P M ( P 6 ) . F o r m o r e i n f o r -

m a t i o n a b o u t P P M l e s , s e e h t t p : / / n e t p b m . s o u r c e f o r g e . n e t / d o c / p p m . h t m l

1 0 . 3 . 5 . L u a s c r i p t i n g l a n g u a g e

T o q u o t e f r o m t h e L u a w e b s i t e ( h t t p : / / w w w . l u a . o r g ) , L u a i s a p o w e r f u l , f a s t , l i g h t w e i g h t ,

e m b e d d a b l e s c r i p t i n g l a n g u a g e . S e l e c t a . l u a l e i n t h e F i l e B r o w s e r t o r u n i t . F o r

m o r e i n f o r m a t i o n o n p r o g r a m m i n g i n L u a , p l e a s e s e e h t t p : / / w w w . l u a . o r g / m a n u a l / 5 . 1 /

a n d h t t p : / / w w w . l u a . o r g / p i l / .

T h e r e a r e a f e w e x c e p t i o n s / a d d i t i o n s t o t h e L u a s u p p o r t i n R o c k b o x :

N o o a t i n g p o i n t s u p p o r t . T h e n u m b e r t y p e i n L u a i s u s u a l l y o a t , h o w e v e r i n t h e

R o c k b o x i m p l e m e n t a t i o n i t i s i n t e g e r .

N o n - s u p p o r t e d l i b r a r i e s . T h e c o r o u t i n e , d e b u g a n d m a t h l i b r a r i e s a r e n o t s u p p o r t e d .

P a r t i a l l y - s u p p o r t e d l i b r a r i e s . T h e o s a n d p a c k a g e l i b r a r i e s a r e o n l y p a r t i a l l y s u p p o r t e d .

A d d i t i o n a l l i b r a r i e s . T h e b i t l i b l i b r a r y i s i n t e g r a t e d t o s u p p o r t b i t w i s e o p e r a t o r s . S e e

h t t p : / / l u a f o r g e . n e t / p r o j e c t s / b i t l i b a n d h t t p : / / l u a - u s e r s . o r g / w i k i / B i t w i s e O p e r a t o r s .

D o c u m e n t a t i o n o f t h e A P I i s s t i l l a w o r k i n p r o g r e s s , a n d t h e A P I i t s e l f i s n o t n a l i s e d .

F o r t h e l a t e s t i n f o r m a t i o n , s e e ZP l u g i n L u a .

N o t e : P l e a s e n o t e t h a t i f a s c r i p t d o e s n o t p r o v i d e a w a y t o e x i t , t h e n t h e o n l y w a y t o be x i t w i l l b e t o r e s e t t h e p l a y e r .


http://www.rockbox.org/wiki/PluginLua

http://lua-users.org/wiki/BitwiseOperators

http://luaforge.net/projects/bitlib

http://www.lua.org/pil/

http://www.lua.org/manual/5.1/

http://www.lua.org/

http://netpbm.sourceforge.net/doc/ppm.html



C h a p t e r 1 0 . P l u g i n s 1 3 3

1 0 . 3 . 6 . M i d i p l a y

T o g e t M I D I l e p l a y b a c k , a p a t c h s e t i s r e q u i r e d . T h i s l e c o n t a i n s t h e i n s t r u m e n t s

r e q u i r e d t o s y n t h e s i z e t h e m u s i c . A s a m p l e p a t c h s e t i s a v a i l a b l e t h r o u g h t h e w i k i a t

ZP l u g i n M i d i P l a y , a n d n e e d s t o b e e x t r a c t e d t o t h e . r o c k b o x d i r e c t o r y i n t h e r o o t o f

y o u r p l a y e r . T h e r e s h o u l d n o w b e a / . r o c k b o x / p a t c h s e t / d i r e c t o r y , w i t h t h e p a t c h s e t

d i r e c t o r y c o n t a i n i n g s e v e r a l . p a t l e s a n d t w o . c f g l e s . J u s t s e l e c t a M I D I l e w i t h

e i t h e r t h e . m i d o r . m i d i e x t e n s i o n i n t h e l e b r o w s e r t o s t a r t p l a y b a c k .


U p / D o w n V o l u m e u p / V o l u m e d o w n

R i g h t / L e f t S k i p 3 s e c o n d s f o r w a r d / b a c k w a r d

A P a u s e / R e s u m e p l a y b a c k

P o w e r S t o p p l a y b a c k a n d q u i t

1 0 . 3 . 7 . M P E G P l a y e r

T h e M p e g P l a y e r i s a v i d e o p l a y e r p l u g i n c a p a b l e o f p l a y i n g b a c k M P E G - 1 a n d M P E G - 2

v i d e o s t r e a m s w i t h M P E G a u d i o m u l t i p l e x e d i n t o . m p g l e s .

T o p l a y a v i d e o l e , y o u j u s t s e l e c t i t i n t h e R o c k b o x F i l e B r o w s e r . I f y o u r l e d o e s

n o t h a v e t h e . m p g e x t e n s i o n b u t i s e n c o d e d i n t h e s u p p o r t e d f o r m a t , y o u w i l l n e e d t o

u s e t h e O p e n W i t h . . . c o n t e x t m e n u o p t i o n a n d c h o o s e m p e g p l a y e r .


S e l e c t o r A P a u s e / R e s u m e

P o w e r S t o p

L e f t o r V o l u m e

d o w n / R i g h t

o r V o l u m e u p

A d j u s t v o l u m e u p / d o w n

U p / D o w n R e w i n d / F a s t F o r w a r d

M e n u O p e n t h e M P E G P l a y e r m e n u

W h e n a v i d e o l e i s s e l e c t e d , t h e S t a r t M e n u w i l l b e d i s p l a y e d , u n l e s s i t i s d i s a b l e d

v i a t h e R e s u m e O p t i o n s ( s e e b e l o w ) . I n t h e l a t t e r c a s e t h e v i d e o w i l l s t a r t p l a y i n g

i m m e d i a t e l y .

S t a r t M e n u

P l a y f r o m b e g i n n i n g R e s u m e i n f o r m a t i o n i s d i s c a r d e d a n d t h e v i d e o p l a y s f r o m t h e

s t a r t .


http://www.rockbox.org/wiki/PluginMidiPlay



C h a p t e r 1 0 . P l u g i n s 1 3 4

R e s u m e a t : m m : s s R e s u m e v i d e o p l a y b a c k a t s t o r e d r e s u m e t i m e m m : s s ( s t a r t o f t h e

v i d e o i f n o r e s u m e t i m e i s f o u n d ) .

S e t s t a r t t i m e A p r e v i e w s c r e e n i s p r e s e n t e d c o n s i s t i n g o f a t h u m b n a i l p r e v i e w a n d a

p r o g r e s s b a r w h e r e t h e u s e r c a n s e l e c t a s t a r t t i m e b y ` s e e k i n g ' t h r o u g h t h e v i d e o .

T h e v i d e o p l a y b a c k i s s t a r t e d b y p r e s s i n g t h e s e l e c t b u t t o n .

S e t t i n g s O p e n S e t t i n g s s u b m e n u s e e b e l o w .

Q u i t m p e g p l a y e r E x i t t h e p l u g i n .

M a i n M e n u

S e t t i n g s O p e n S e t t i n g s s u b m e n u s e e b e l o w .

R e s u m e p l a y b a c k R e t u r n t o p l a y b a c k s c r e e n .

Q u i t m p e g p l a y e r E x i t t h e p l u g i n .

S e t t i n g s M e n u

D i s p l a y O p t i o n s O p e n D i s p l a y O p t i o n s s u b m e n u s e e b e l o w .

A u d i o O p t i o n s O p e n A u d i o O p t i o n s s u b m e n u s e e b e l o w .

R e s u m e O p t i o n s ( d e f a u l t : S t a r t m e n u ) E n a b l e / d i s a b l e t h e s t a r t m e n u .

P l a y M o d e ( d e f a u l t : S i n g l e ) S e t t o A l l t o p l a y m u l t i p l e . m p g

l e s i n t h e d i r e c t o r y

c o n t i n u o u s l y .

C l e a r a l l r e s u m e s : x D i s c a r d a l l x r e s u m e p o i n t s .

D i s p l a y O p t i o n s M e n u

D i t h e r i n g ( d e f a u l t : o ) P r e v e n t b a n d i n g e e c t s i n g r a d i e n t s b y b l e n d i n g o f c o l o u r s .

( o n l y a v a i l a b l e o n S a n s a e 2 0 0 , S a n s a c 2 0 0 a n d G i g a b e a t F / X )

D i s p l a y F P S ( d e f a u l t : o ) T h i s o p t i o n d i s p l a y s ( o n c e a s e c o n d - i f y o u r v i d e o i s f u l l -

s c r e e n t h i s m e a n s i t w i l l g e t o v e r w r i t t e n b y t h e v i d e o a n d a p p e a r t o a s h o n c e

p e r s e c o n d ) t h e a v e r a g e n u m b e r o f f r a m e s d e c o d e d p e r s e c o n d , t h e t o t a l n u m b e r

o f f r a m e s s k i p p e d ( s e e t h e S k i p F r a m e s o p t i o n ) , t h e c u r r e n t t i m e ( i n 1 0 0 H z t i c k s )

a n d t h e t i m e t h e c u r r e n t f r a m e i s d u e t o b e d i s p l a y e d .

L i m i t F P S ( d e f a u l t : o n ) W i t h t h i s o p t i o n d i s a b l e d , m p e g p l a y e r w i l l d i s p l a y t h e v i d e o a s

f a s t a s i t c a n . U s e f u l f o r b e n c h m a r k i n g .

S k i p f r a m e s ( d e f a u l t : o n ) T h i s o p t i o n c a u s e s m p e g p l a y e r t o a t t e m p t t o m a i n t a i n r e a l -

t i m e p l a y b a c k b y s k i p p i n g t h e d i s p l a y o f f r a m e s - b u t t h e s e f r a m e s a r e s t i l l d e c o d e d .

D i s a b l i n g t h i s o p t i o n c a n c a u s e l o s s o f A / V s y n c .




C h a p t e r 1 0 . P l u g i n s 1 3 5

B a c k l i g h t B r i g h t n e s s ( d e f a u l t : U s e s e t t i n g ) C h o o s e b r i g h t n e s s t o u s e d u r i n g v i d e o p l a y -

b a c k . S e t t o U s e s e t t i n g t o u s e t h e B r i g h t n e s s s e t t i n g .

A u d i o O p t i o n s M e n u

T o n e C o n t r o l s ( d e f a u l t : f o r c e o ) U s e t h e b a s s a n d t r e b l e c o n t r o l s e t t i n g s o r f o r c e t h e m

o .

C h a n n e l M o d e s ( d e f a u l t : f o r c e o ) U s e t h e c h a n n e l c o n g u r a t i o n s e t t i n g o r f o r c e S t e r e o

m o d e .

C r o s s f e e d ( d e f a u l t : f o r c e o ) U s e t h e C r o s s f e e d s e t t i n g o r f o r c e c r o s s f e e d o .

E q u a l i z e r ( d e f a u l t : f o r c e o ) U s e t h e E q u a l i z e r s e t t i n g o r f o r c e t h e e q u a l i z e r o .

D i t h e r i n g ( d e f a u l t : f o r c e o ) U s e t h e D i t h e r i n g s e t t i n g o r f o r c e a u d i o d i t h e r i n g o .

S e e t h i s p a g e i n t h e R o c k b o x w i k i f o r i n f o r m a t i o n o n h o w t o e n c o d e y o u r v i d e o s t o t h e

s u p p o r t e d f o r m a t . ZP l u g i n M p e g p l a y e r

1 0 . 3 . 8 . M P 3 E n c o d e r

T h i s p l u g i n e n c o d e s a . w a v l e t o M P 3 f o r m a t . T h e s u p p o r t e d i n p u t f o r m a t i s u n c o m -

p r e s s e d , l i n e a r P C M w i t h 1 6 b i t p e r s a m p l e a n d a m a x i m u m o f 2 c h a n n e l s . A l l o w e d

s a m p l e r a t e s a r e 1 6 , 2 2 . 0 5 , 2 4 , 3 2 , 4 4 . 1 a n d 4 8 k H z . T h e u s e r w i l l b e a s k e d t o s e l e c t t h e

d e s i r e d o u t p u t b i t r a t e o f t h e c o m p r e s s e d M P 3 l e .

S e l e c t B i t r a t e T h e f o l l o w i n g b i t r a t e s c a n b e s e l e c t e d : 6 4 , 8 0 , 9 6 , 1 1 2 , 1 2 8 , 1 6 0 , 1 9 2 ,

2 2 4 , 2 5 6 , 3 2 0 k b p s .

R e m a r k : B i t r a t e s a b o v e 1 6 0 k b p s c a n n o t b e u s e d i n M P E G 2 L a y e r 3 b i t s t r e a m s .

T h e e n c o d e r p l u g i n a u t o m a t i c a l l y l i m i t s t h e o u t p u t b i t r a t e t o 1 6 0 k b p s f o r i n p u t

l e s w i t h a s a m p l e r a t e o f 1 6 , 2 2 . 0 5 o r 2 4 k H z . T h e s a m e l i m i t a t i o n i s v a l i d f o r

m o n o l e s .

T h e o u t p u t . m p 3 l e i s w r i t t e n t o t h e s a m e p a t h a s t h e . w a v l e u s i n g t h e s a m e

l e n a m e . T o u s e t h i s p l u g i n , o p e n t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) o n

a . w a v l e a n d s e l e c t O p e n W i t h . . . → m p 3 _ e n c o d e r .

N o t e : T h e e n c o d e r w i l l c h o o s e t h e a p p r o p r i a t e b i t s t r e a m f o r m a t f r o m t h e s a m p l e r a t e o f bt h e i n p u t l e . T h e o u t p u t b i t s t r e a m f o r m a t i s M P E G 1 L a y e r 3 f o r 3 2 , 4 4 . 1 a n d 4 8 k H z ,

a n d M P E G 2 L a y e r 3 f o r 1 6 , 2 2 . 0 5 a n d 2 4 k H z . M P E G 2 . 5 L a y e r 3 i s n o t s u p p o r t e d .


http://www.rockbox.org/wiki/PluginMpegplayer



C h a p t e r 1 0 . P l u g i n s 1 3 6

1 0 . 3 . 9 . R o c k b o y

F i g u r e 1 0 . 4 3 . : R o c k b o y

R o c k b o y i s a N i n t e n d o G a m e B o y a n d G a m e B o y C o l o r e m u l a t o r f o r R o c k b o x b a s e d o n

t h e g n u b o y e m u l a t o r . T o s t a r t a g a m e , o p e n a R O M l e s a v e d a s . g b o r . g b c i n t h e l e

b r o w s e r .

D e f a u l t k e y s


U p / D o w n

L e f t / R i g h t

D i r e c t i o n k e y s

V o l u m e u p A b u t t o n

V o l u m e d o w n B b u t t o n

A S t a r t

S e l e c t S e l e c t

M e n u O p e n R o c k b o y m e n u

R o c k b o y m e n u

L o a d G a m e . . . L o a d s a p r e v i o u s l y s a v e d g a m e .




C h a p t e r 1 0 . P l u g i n s 1 3 7

S a v e G a m e . . . S a v e s y o u r c u r r e n t s t a t e .

O p t i o n s . . . M a x F r a m e s k i p . C h a n g e f r a m e s k i p s e t t i n g t o i m p r o v e s p e e d .

S o u n d . T o g g l e s o u n d o n o r o .

S t a t s . T o g g l e s h o w i n g f p s a n d c u r r e n t f r a m e s k i p .

S e t K e y s ( B U G G Y ) S e l e c t t h i s o p t i o n t o s e t a n e w k e y m a p p i n g .

N o t e : T h e d i r e c t i o n k e y s a r e s e t f o r t h e n o r m a l s c r e e n o r i e n t a t i o n , n o t t h e br o t a t e d o r i e n t a t i o n .

S c r e e n S i z e . C h o o s e w h e t h e r t h e o r i g i n a l a s p e c t r a t i o s h o u l d b e k e p t w h e n s c a l i n g

t h e p i c t u r e t o t h e s c r e e n o r w h e t h e r i t s h o u l d b e d i s p l a y e d u n s c a l e d .

S c r e e n R o t a t e . R o t a t e t h e d i s p l a y e d p i c t u r e a n d d i r e c t i o n k e y s b y 9 0 d e g r e e s .

S e t P a l e t t e . P i c k o n e o f a f e w p r e d e n e d c o l o u r p a l e t t e s .

R e s e t . R e s e t s t h e E m u l a t o r .

Q u i t R o c k B o y . Q u i t s t h e R o c k b o y p l u g i n .

1 0 . 3 . 1 0 . S e a r c h

T h i s p l u g i n c a n b e u s e d o n p l a y l i s t s . I t s e a r c h e s t h r o u g h t h e p l a y l i s t t h a t i t o p e n e d o n

l o o k i n g f o r a n y o c c u r r e n c e s o f t h e s t r i n g e n t e r e d b y t h e u s e r . T h e r e s u l t s o f t h i s s e a r c h

a r e s a v e d t o a n e w p l a y l i s t , s e a r c h _ r e s u l t s . m 3 u , w i t h i n t h e s a m e d i r e c t o r y a s t h e

o r i g i n a l p l a y l i s t .

1 0 . 3 . 1 1 . S h o p p e r

S h o p p e r i s a s h o p p i n g l i s t p l u g i n w h i c h a l l o w s y o u t o m a i n t a i n r e u s a b l e s h o p p i n g l i s t s .

1 0 . 3 . 1 2 . S o r t

T h i s p l u g i n t a k e s a l e a n d s o r t s i t i n a s c e n d i n g a l p h a b e t i c a l o r d e r . C a s e i s i g n o r e d .

T h i s i s u s e f u l f o r o r d e r i n g p l a y l i s t s g e n e r a t e d b y t h e C r e a t e P l a y l i s t m e n u o p t i o n

( s e e s e c t i o n 5 . 8 ( p a g e 4 4 ) ) .




C h a p t e r 1 0 . P l u g i n s 1 3 8

1 0 . 3 . 1 3 . T e x t V i e w e r

F i g u r e 1 0 . 4 4 . : T e x t V i e w e r

T h i s i s a V i e w e r f o r t e x t l e s w i t h w o r d w r a p . J u s t o p e n a . t x t o r . n f o l e t o d i s p l a y i t .

T h e t e x t v i e w e r f e a t u r e s c o n t r o l s t o h a n d l e v a r i o u s s t y l e s o f t e x t f o r m a t t i n g a n d h a s t o p -

o f - l e a n d b o t t o m - o f - l e b u t t o n s . Y o u c a n v i e w l e s w i t h o u t a . t x t o r . n f o e x t e n s i o n

b y u s i n g O p e n w i t h f r o m t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) . Y o u c a n a l s o

b o o k m a r k p a g e s .




C h a p t e r 1 0 . P l u g i n s 1 3 9



U p S c r o l l - u p

D o w n S c r o l l - d o w n

L e f t T o p o f l e ( N a r r o w m o d e ) / O n e s c r e e n

l e f t ( W i d e m o d e )

R i g h t B o t t o m o f l e ( N a r r o w m o d e ) / O n e

s c r e e n r i g h t ( W i d e m o d e )

A + U p O n e l i n e u p

A + D o w n O n e l i n e d o w n

A + L e f t O n e c o l u m n l e f t

A + R i g h t O n e c o l u m n r i g h t

A T o g g l e a u t o s c r o l l

S e l e c t S e t / R e s e t b o o k m a r k s

M e n u E n t e r m e n u

P o w e r E x i t t e x t v i e w e r

M e n u

R e t u r n R e t u r n t o t h e l e b e i n g v i e w e d .

V i e w e r O p t i o n s C h a n g e s e t t i n g s f o r t h e c u r r e n t l e .

E n c o d i n g S e t t h e c o d e p a g e i n t h e t e x t v i e w e r . A v a i l a b l e s e t t i n g s : I S O - 8 8 5 9 - 1

( L a t i n 1 ) . I S O - 8 8 5 9 - 7 ( G r e e k ) , I S O - 8 8 5 9 - 8 ( H e b r e w ) , C P 1 2 5 1 ( C y r i l l i c ) ,

I S O - 8 8 5 9 - 1 1 ( T h a i ) , C P 1 2 5 6 ( A r a b i c ) , I S O - 8 8 5 9 - 9 ( T u r k i s h ) , I S O - 8 8 5 9 - 2

( L a t i n E x t e n d e d ) , C P 1 2 5 0 ( C e n t r a l E u r o p e a n ) , S J I S ( J a p a n e s e ) , G B - 2 3 1 2

( S i m p l e C h i n e s e ) , K S X - 1 0 0 1 ( K o r e a n ) , B I G 5 ( T r a d i t i o n a l C h i n e s e ) , U T F - 8

( U n i c o d e ) , T h i s s e t t i n g o n l y a p p l i e s t o t h e p l u g i n a n d i s i n d e p e n d e n t f r o m t h e

D e f a u l t C o d e p a g e s e t t i n g ( s e e s e c t i o n 8 . 4 ( p a g e 6 5 ) ) .

W o r d W r a p T o g g l e w o r d w r a p m o d e .

O n B r e a k l i n e s a t t h e m a x i m u m c o l u m n l i m i t .

O ( C h o p W o r d s ) B r e a k l i n e s a t w h i t e s p a c e o r h y p h e n .

L i n e M o d e C h a n g e h o w l i n e s a r e d i s p l a y e d .

N o r m a l B r e a k l i n e s a t n e w l i n e c h a r a c t e r s .

J o i n J o i n l i n e s t o g e t h e r .

E x p a n d A d d a b l a n k l i n e a t n e w l i n e s . U s e f u l f o r m a k i n g p a r a g r a p h s c l e a r e r

i n s o m e b o o k s t y l e t e x t l e s .

R e o w L i n e s J u s t i f y t h e t e x t .




C h a p t e r 1 0 . P l u g i n s 1 4 0

S c r e e n s P e r P a g e S e t t h e n u m b e r o f s c r e e n s p e r p a g e . A v a i l a b l e o p t i o n s a r e 1 t o

5 s c r e e n s p e r p a g e .

A l i g n m e n t S e t t h e t e x t a l i g n m e n t .

R i g h t S e t t h e t e x t a l i g n m e n t t o t h e r i g h t . ( U s e f u l f o r d i s p l a y i n g r i g h t - t o - l e f t

l a n g u a g e s , s u c h a s A r a b i c o r H e b r e w )

L e f t S e t t h e t e x t a l i g n m e n t t o t h e l e f t .

S h o w H e a d e r S e l e c t w h e t h e r t o s h o w t h e h e a d e r . T h e h e a d e r d i s p l a y s t h e l e

p a t h .

N o D o n o t d i s p l a y t h e h e a d e r .

Y e s D i s p l a y t h e h e a d e r .

S h o w F o o t e r S e l e c t w h e t h e r t o s h o w t h e f o o t e r . T h e f o o t e r d i s p a y s t h e p a g e

n u m b e r .

N o D o n o t d i s p l a y t h e f o o t e r .

Y e s D i s p l a y t h e f o o t e r .

F o n t S e l e c t t h e f o n t t o b e u s e d b y t h e T e x t V i e w e r .

S h o w S t a t u s b a r S e l e c t w h e t h e r t o s h o w t h e s t a t u s b a r . I f y o u s e l e c t a t h e m e

s e t t i n g s t h a t t h e s t a t u s b a r d o e s n o t d i s p l a y ( s e e s e c t i o n 9 ( p a g e 7 2 ) ) , t h e

s t a t u s b a r i s n o t d i s p l a y e d e v e n i f y o u s e l e c t Y e s .

N o D o n o t d i s p l a y t h e s t a t u s b a r .

Y e s D i s p l a y t h e s t a t u s b a r .

S c r o l l S e t t i n g s T h e s c r o l l i n g s e t t i n g s s u b m e n u .

H o r i z o n t a l S u b m e n u f o r h o r i z o n t a l s c r o l l i n g s e t t i n g s .

S c r o l l b a r T o g g l e t h e h o r i z o n t a l s c r o l l b a r f o r t h e c u r r e n t m o d e . I f t h e l e

t s o n o n e s c r e e n , t h e r e i s n o s c r o l l b a r a n d t h i s s e t t i n g h a s n o e e c t .

N o D o n o t d i s p l a y t h e h o r i z o n t a l s c r o l l b a r .

Y e s D i s p l a y t h e h o r i z o n t a l s c r o l l b a r .

S c r o l l M o d e C h a n g e t h e f u n c t i o n o f t h e L e f t a n d R i g h t b u t t o n s .

S c r o l l b y S c r e e n M o v e t o t h e p r e v i o u s / n e x t s c r e e n .

S c r o l l b y C o l u m n M o v e t o t h e p r e v i o u s / n e x t c o l u m n .

V e r t i c a l S u b m e n u f o r v e r t i c a l s c r o l l i n g s e t t i n g s .

S c r o l l b a r T o g g l e t h e v e r t i c a l s c r o l l b a r f o r t h e c u r r e n t m o d e . I f t h e l e

t s o n o n e s c r e e n , t h e r e i s n o s c r o l l b a r a n d t h i s s e t t i n g h a s n o e e c t .

N o D o n o t d i s p l a y t h e v e r t i c a l s c r o l l b a r .

Y e s D i s p l a y t h e v e r t i c a l s c r o l l b a r .

S c r o l l M o d e C h a n g e t h e f u n c t i o n o f t h e S c r o l l - u p a n d S c r o l l - d o w n

b u t t o n s .




C h a p t e r 1 0 . P l u g i n s 1 4 1

S c r o l l b y P a g e S c r o l l u p o r d o w n o n e f u l l s c r e e n .

S c r o l l b y L i n e S c r o l l u p o r d o w n o n e l i n e .

O v e r l a p P a g e s S e t w h e t h e r t h e l a s t l i n e f r o m t h e p r e v i o u s s c r e e n i s r e -

t a i n e d w h e n s c r o l l i n g p a g e s .

N o D o n o t r e t a i n p r e v i o u s l i n e .

Y e s R e t a i n p r e v i o u s l i n e .

A u t o - s c r o l l S p e e d C o n t r o l t h e s p e e d o f a u t o - s c r o l l i n g i n n u m b e r o f l i n e s

p e r s e c o n d . A v a i l a b l e o p t i o n s a r e 1 t o 1 0 l i n e s p e r s e c o n d . A s a n

e x a m p l e , 4 w i l l s c r o l l t h e t e x t a t f o u r l i n e s p e r s e c o n d .

L e f t / R i g h t K e y ( N a r r o w m o d e ) C h a n g e t h e f u n c t i o n o f t h e L e f t a n d

R i g h t b u t t o n s w h e n t h e s c r e e n i s i n n a r r o w m o d e ( i . e . o n e s c r e e n

p e r p a g e ) .

P r e v i o u s / N e x t P a g e S c r o l l u p o r d o w n o n e f u l l s c r e e n .

T o p / B o t t o m P a g e M o v e t o t h e t o p o r b o t t o m p a g e .

I n d e n t S p a c e s S e t t h e n u m b e r o f s p a c e s t o i n d e n t t h e t e x t w h e n l i n e m o d e i s s e t

t o R e f l o w L i n e s . A v a i l a b l e o p t i o n s a r e 0 t o 5 s p a c e s . I f y o u s e l e c t 0 , a

b l a n k l i n e i s d i s p l a y e d a s a n i n d e n t .

S h o w P l a y b a c k M e n u D i s p l a y t h e p l a y b a c k m e n u t o a l l o w c o n t r o l o f t h e c u r r e n t l y p l a y -

i n g m u s i c w i t h o u t l e a v i n g t h e p l u g i n .

S e l e c t B o o k m a r k S e l e c t a s a v e d b o o k m a r k . I n t h e s c r e e n s h o t b e l o w , t h e * d e n o t e s

t h e c u r r e n t p a g e .




C h a p t e r 1 0 . P l u g i n s 1 4 2

F i g u r e 1 0 . 4 5 . : T h e s e l e c t b o o k m a r k m e n u

G l o b a l S e t t i n g s S e t t h e d e f a u l t s e t t i n g s f o r t h e t e x t v i e w e r . T h e s e t t i n g i t e m s a r e t h e

s a m e a s V i e w e r O p t i o n s . T h e g l o b a l s e t t i n g s a r e s t o r e d i n . r o c k b o x / r o c k s / v i e w e r s / v i e w e r . d a t

.

Q u i t E x i t s t h e p l u g i n . T h e t e x t v i e w e r a u t o m a t i c a l l y s t o r e s i t s s e t t i n g s , t h e c u r r e n t

p o s i t i o n a n d b o o k m a r k s i n . r o c k b o x / r o c k s / v i e w e r s / v i e w e r _ f i l e . d a t .

B o o k m a r k s

T o a d d a b o o k m a r k , p r e s s S e l e c t . T h e b o o k m a r k w i l l b e d i s p l a y e d a s s h o w n b e l o w . T o

d e l e t e t h e b o o k m a r k p r e s s t h e s a m e b u t t o n a g a i n .




C h a p t e r 1 0 . P l u g i n s 1 4 3

F i g u r e 1 0 . 4 6 . : A b o o k m a r k

1 0 . 3 . 1 4 . T h e m e R e m o v e

T h i s p l u g i n o e r s a w a y t o r e m o v e a t h e m e . O p e n t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2

( p a g e 2 4 ) ) u p o n a t h e m e . c f g l e a n d s e l e c t O p e n W i t h . . . → t h e m e _ r e m o v e . S o m e

l e s a r e n o t r e m o v e d r e g a r d l e s s o f t h e R e m o v e O p t i o n s s u c h a s r o c k b o x _ d e f a u l t . w p s

a n d t h e f o n t l e c u r r e n t l y i n u s e .

T h e m e R e m o v e m e n u

R e m o v e T h e m e . S e l e c t i n g t h i s w i l l d e l e t e t h e l e s s p e c i e d i n t h e R e m o v e O p t i o n s .

A f t e r a t h e m e h a s b e e n s u c c e s f u l l y r e m o v e d , a l o g m e s s a g e i s d i s p l a y e d l i s t i n g w h i c h

i t e m s h a v e b e e n d e l e t e d a n d w h i c h a r e b e i n g k e p t . E x i t t h i s s c r e e n b y p r e s s i n g a n y

k e y . A l e c a l l e d t h e m e _ r e m o v e _ l o g . t x t i s c r e a t e d i n t h e r o o t d i r e c t o r y o f y o u r

p l a y e r l i s t i n g a l l t h e c h a n g e s .

R e m o v e O p t i o n s . T h i s m e n u s p e c i e s w h i c h i t e m s a r e r e m o v e d i f R e m o v e T h e m e i s

s e l e c t e d i n t h e m e n u .

O n e o f t h e f o l l o w i n g o p t i o n s c a n b e c h o s e n f o r e a c h s e t t i n g .

A s k f o r R e m o v a l . S e l e c t i n g t h i s o p t i o n b r i n g s u p a d i a l o g u e w i t h t w o o p t i o n s :

p r e s s S e l e c t t o c o n r m d e l e t i o n o r a n y o t h e r k e y t o c a n c e l .

R e m o v e i f n o t U s e d . S e l e c t i n g t h i s o p t i o n w i l l r e m o v e t h e l e a u t o m a t i c a l l y , i f i t

i s n o t u s e d b y a n o t h e r t h e m e i n t h e t h e m e d i r e c t o r y a n d n o t c u r r e n t l y u s e d .

N e v e r R e m o v e . S e l e c t i n g t h i s o p t i o n w i l l a l w a y s s k i p d e l e t i n g t h e l e .




C h a p t e r 1 0 . P l u g i n s 1 4 4

A l w a y s R e m o v e . S e l e c t i n g t h i s o p t i o n w i l l r e m o v e t h e l e w i t h n o r e g a r d t o w h e t h e r

i t ' s u s e d b y a n o t h e r t h e m e o r n o t .

F o n t . S p e c i e s h o w t h e . f n t l e b e l o n g i n g t o a t h e m e . c f g l e i s h a n d l e d . I f t h i s

o p t i o n i s s e t t o R e m o v e i f n o t U s e d , t h e f o n t s c a m e f r o m r o c k b o x - f o n t s . z i p

w i l l n o t b e r e m o v e d a s t h e m e s m a y d e p e n d o n t h o s e f o n t s .

W P S . S p e c i e s h o w t h e . w p s l e b e l o n g i n g t o a t h e m e . c f g l e i s h a n d l e d .

S t a t u s b a r S k i n . S p e c i e s h o w t h e . s b s

l e b e l o n g i n g t o a t h e m e . c f g

l e i s h a n -

d l e d .

B a c k d r o p . S p e c i e s h o w t h e b a c k d r o p . b m p l e b e l o n g i n g t o a t h e m e . c f g l e i s

h a n d l e d .

I c o n s e t . S p e c i e s h o w t h e i c o n s e t . b m p l e b e l o n g i n g t o a t h e m e . c f g l e i s h a n -

d l e d .

V i e w e r s I c o n s e t . S p e c i e s h o w t h e v i e w e r s i c o n s e t . b m p l e b e l o n g i n g t o a t h e m e

. c f g l e i s h a n d l e d .

F i l e t y p e C o l o u r s . S p e c i e s h o w t h e c o l o u r s . c o l o u r s l e b e l o n g i n g t o a t h e m e

. c f g l e i s h a n d l e d .

C r e a t e L o g F i l e . S e t t i n g t h i s t o N o p r e v e n t s t h e l o g l e f r o m b e i n g c r e a t e d .

Q u i t . E x i t s t h i s p l u g i n .

1 0 . 3 . 1 5 . V B R x

T h i s f u n c t i o n s c a n s a V B R ( V a r i a b l e B i t r a t e ) M P 3 l e a n d u p d a t e s / c r e a t e s t h e X i n g

V B R h e a d e r . T h e X i n g h e a d e r c o n t a i n s i n f o r m a t i o n a b o u t t h e V B R s t r e a m u s e d t o c a l -

c u l a t e a v e r a g e b i t r a t e , t i m e i n f o r m a t i o n a n d t o m o r e a c c u r a t e l y f w d / r e w i n t h e s t r e a m .

T h i s f u n c t i o n i s e s p e c i a l l y u s e f u l w h e n t h e p l a y b a c k o f a l e s k i p s , f w d / r e w d o e s n o t w o r k

c o r r e c t l y o r t h e t i m e d i s p l a y i s i n c o r r e c t . T o u s e t h i s p l u g i n , o p e n t h e C o n t e x t M e n u

( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) u p o n a . m p 3 l e a n d s e l e c t O p e n W i t h . . . → v b r f i x .

N o t e : V B R x c a n o n l y r u n w h e n m u s i c i s t u r n e d o ( s i n c e i t u s e s t h e s a m e m e m o r y a s bt h e p l a y e r ) a n d c a n t a k e a w h i l e t o c o m p l e t e i f r u n o n b i g l e s .




C h a p t e r 1 0 . P l u g i n s 1 4 5

1 0 . 3 . 1 6 . Z X B o x

F i g u r e 1 0 . 4 7 . : Z X B o x

Z X B o x i s a p o r t o f t h e S p e c t e m u Z X S p e c t r u m 4 8 k e m u l a t o r f o r R o c k b o x ( Zp r o j e c t ' s

h o m e p a g e ) . T o s t a r t a g a m e o p e n a t a p e l e o r s n a p s h o t s a v e d a s . t a p , . t z x , . z 8 0 o r

. s n a i n t h e l e b r o w s e r .

N o t e : A s Z X B o x i s a 4 8 k e m u l a t o r o n l y l o a d i n g o f 4 8 k z 8 0 s n a p s h o t s i s p o s s i b l e . b


T h e e m u l a t o r i s s e t u p f o r 5 d i e r e n t b u t t o n s : U p , D o w n , L e f t , R i g h t a n d J u m p / F i r e .

E a c h o n e o f t h e s e c a n b e m a p p e d t o o n e k e y o f t h e S p e c t r u m K e y b o a r d o r t h e y c a n b e

u s e d l i k e a K e m p s t o n j o y s t i c k . P e r d e f a u l t t h e b u t t o n s , i n c l u d i n g a n a d d i t i o n a l b u t

x e d m e n u b u t t o n , a r e a s s i g n e d a s f o l l o w s :


U p / D o w n /

L e f t / R i g h t

D i r e c t i o n a l m o v e m e n t

S e l e c t J u m p / F i r e

M e n u O p e n Z X B o x m e n u


http://kempelen.iit.bme.hu/~mszeredi/spectemu/spectemu.html

http://kempelen.iit.bme.hu/~mszeredi/spectemu/spectemu.html



C h a p t e r 1 0 . P l u g i n s 1 4 6

Z X B o x m e n u

V k e y b o a r d . T h i s i s a v i r t u a l k e y b o a r d r e p r e s e n t i n g t h e S p e c t r u m k e y b o a r d . C o n t r o l s

a r e t h e s a m e a s i n s t a n d a r d R o c k b o x , b u t y o u j u s t p r e s s o n e k e y i n s t e a d o f e n t e r i n g

a p h r a s e .

P l a y / P a u s e T a p e . T o g g l e s p l a y i n g o f t h e t a p e ( i f i t i s l o a d e d ) .

S a v e Q u i c k S n a p s h o t . S a v e s s n a p s h o t i n t o / . r o c k b o x / z x b o x q . z 8 0 .

L o a d Q u i c k S n a p s h o t . L o a d s s n a p s h o t f r o m / . r o c k b o x / z x b o x q . z 8 0 .

S a v e S n a p s h o t . S a v e s a s n a p s h o t o f t h e c u r r e n t s t a t e . Y o u w o u l d e n t e r t h e f u l l p a t h a n d

d e s i r e d n a m e - f o r e x a m p l e / g a m e s / z x / s n a p s h o t s / c h u c k i e . s n a . T h e s n a p s h o t

f o r m a t w i l l b e c h o s e n a f t e r t h e e x t e n s i o n y o u s p e c i e d , p e r d e f a u l t . z 8 0 w i l l b e

t a k e n i n c a s e y o u l e a v e i t o p e n .

T o g g l e F a s t M o d e . T o g g l e s f a s t e s t p o s s i b l e e m u l a t i o n s p e e d ( n o s o u n d , m a x i m u m f r a m e s k i p

e t c . ) . T h i s i s U s e f u l w h e n l o a d i n g t a p e s w i t h s o m e s p e c i c l o a d e r s .

O p t i o n s . M a p K e y s T o K e m p s t o n . C o n t r o l s w h e t h e r t h e p l a y e r ' s b u t t o n s s h o u l d s i m -

u l a t e a K e m p s t o n j o y s t i c k o r s o m e a s s i g n e d k e y s o f t h e S p e c t r u m k e y b o a r d .

D i s p l a y S p e e d . T o g g l e d i s p l a y i n g t h e e m u l a t i o n s p e e d ( i n p e r c e n t ) .

I n v e r t C o l o u r s . I n v e r t s t h e S p e c t r u m c o l o u r p a l e t t e , s o m e t i m e s h e l p s v i s i b i l i t y .

F r a m e s k i p S e t s t h e n u m b e r o f f r a m e s t o s k i p b e f o r e d i s p l a y i n g o n e . W i t h z e r o

f r a m e s k i p Z X B o x t r i e s t o d i s p l a y 5 0 f r a m e s p e r s e c o n d .

S o u n d . T u r n s s o u n d o n o r o .

V o l u m e . C o n t r o l s v o l u m e o f s o u n d o u t p u t .

P r e d e n e d K e y m a p S e l e c t o n e o f t h e p r e d e n e d k e y m a p s . F o r e x a m p l e 2 w 9 0 z

m e a n s : m a p Z X B o x ' s U p t o 2 , D o w n t o w , L e f t t o 9 , R i g h t t o 0 a n d

J u m p / F i r e t o z . T h i s e x a m p l e k e y m a p i s u s e d i n t h e C h u c k i e E g g g a m e .

C u s t o m K e y m a p T h i s m e n u a l l o w s y o u t o m a p o n e o f t h e S p e c t r u m k e y s a c c e s s i b l e

t h r o u g h t h e p l u g i n ' s v i r t u a l k e y b o a r d t o e a c h o n e o f t h e b u t t o n s .

Q u i t . Q u i t s t h e e m u l a t o r . .

H a c k i n g g r a p h i c s

D u e t o Z X B o x ' s s i m p l e ( b u t f a s t ) s c a l i n g t o t h e s c r e e n b y d r o p p i n g l i n e s a n d c o l u m n s

s o m e g a m e s c a n b e c o m e u n p l a y a b l e . I t i s p o s s i b l e t o h a c k g r a p h i c s t o m a k e t h e m b e t t e r

v i s i b l e w i t h t h e h e l p o f a n u t i l i t y s u c h a s t h e S p e c t r u m G r a p h i c s E d i t o r . U s e f u l t o o l s c a n

b e f o u n d a t t h e W o r l d o f S p e c t r u m s i t e ( h t t p : / / w w w . w o r l d o f s p e c t r u m . o r g / u t i l i t i e s . h t m l ) .


http://www.worldofspectrum.org/utilities.html



C h a p t e r 1 0 . P l u g i n s 1 4 7

1 0 . 4 . A p p l i c a t i o n s

1 0 . 4 . 1 . A l a r m C l o c k

T h i s p l u g i n i s a n a l a r m c l o c k , w h i c h r e s u m e s a p a u s e d s o n g a t a g i v e n t i m e .

K e y c o n g u r a t i o n



/ V o l u m e U p

S w i t c h b e t w e e n h o u r s / m i n u t e s s e l e c t i o n


R e w i n d

I n c r e a s e / D e c r e a s e h o u r s / m i n u t e s

S e l e c t S e t t h e a l a r m

P o w e r E x i t

S e t t i n g a n a l a r m

F i r s t s e l e c t a t r a c k a n d p l a y i t , t h e n l a u n c h t h e a l a r m c l o c k p l u g i n . T h e p l u g i n p a u s e s

t h e p l a y b a c k . E n t e r a 2 4 h - t i m e ( e . g . 1 3 : 5 8 ) a n d s e t t h e a l a r m . M u s i c p l a y b a c k w i l l

r e s u m e w h e n t h e s e t t i m e i s r e a c h e d .

1 0 . 4 . 2 . B a t t e r y B e n c h m a r k

T h e B a t t e r y B e n c h m a r k p l u g i n e n a b l e s y o u t o t e s t y o u r b a t t e r y ' s p e r f o r m a n c e w h i l s t

u s i n g y o u r p l a y e r n o r m a l l y . R e s u l t s c a n b e s u b m i t t e d t o t h e ZB a t t e r y R u n t i m e w i k i p a g e .

H o w i t w o r k s

O n c e l o a d e d , B a t t e r y B e n c h m a r k r u n s i n t h e b a c k g r o u n d r e c o r d i n g v a r i o u s i n f o r m a -

t i o n a b o u t y o u r b a t t e r y t o m e m o r y . A n e w p o i n t i s w r i t t e n t o m e m o r y e v e r y m i n u t e .

E v e r y t i m e t h e d i s k i s a c c e s s e d f o r a n y r e a s o n ( s u c h a s r e l l i n g t h e a u d i o b u e r , o p e n i n g

a d i r e c t o r y o r e n t e r i n g U S B m o d e e t c . ) t h e n t h e i n f o r m a t i o n i n m e m o r y i s w r i t t e n t o

d i s k . O n c e t h e m e m o r y b e c o m e s f u l l ( a f t e r m a n y h o u r s ) , t h e n t h e d a t a a r e w r i t t e n t o d i s k

a n y w a y . T h i s i s d o n e s o t h a t t h e d a t a a r e n o t b i a s e d b y e x c e s s i v e a d d i t i o n a l d i s k a c c e s s e s .

T h e l e i s w r i t t e n t o t h e r o o t d i r e c t o r y o f y o u r p l a y e r a n d i s c a l l e d b a t t e r y _ b e n c h . t x t .

T h e p l u g i n w i l l c o n t i n u e t o l o g i n f o u n t i l :

• A n o t h e r p l u g i n i s l o a d e d .

• T h e p l a y e r i s s h u t d o w n .

• T h e b a t t e r y i s e m p t y .


http://www.rockbox.org/wiki/BatteryRuntime



C h a p t e r 1 0 . P l u g i n s 1 4 8

B e n c h m a r k s c a n b e r e s u m e d i f y o u a c c i d e n t a l l y l o a d a p l u g i n , o r t u r n o y o u r p l a y e r ,

s o l o n g a s t h e l o g l e b a t t e r y _ b e n c h . t x t i s n o t d e l e t e d .

I n f o r m a t i o n e x p l a i n e d

A t t h e t o p o f t h e b a t t e r y _ b e n c h . t x t l e i s v a r i o u s i n f o r m a t i o n o n h o w t o u s e t h e p l u g i n ,

f o l l o w e d b y t h e d a t a t h e m s e l v e s .

T i m e T h i s c o l u m n r e p o r t s t h e t o t a l t i m e o f o p e r a t i o n o f t h e p l a y e r . I t i s n o t t h e t i m e

t h a t y o u s t a r t e d t h e p l u g - i n . I f y o u h a v e y o u r p l a y e r o n f o r 5 m i n u t e s a n d t h e n

s t a r t t h e p l u g i n , i t w i l l s t a r t m e a s u r i n g f r o m 5 m i n u t e s .

S e c o n d s T h e s a m e a s T i m e , e x c e p t m e a s u r e d i n s e c o n d s .

L e v e l T h e p e r c e n t l e v e l o f t h e b a t t e r y e s t i m a t e d b y R o c k b o x , a n d n o t t h e a c t u a l b a t t e r y

l e v e l . T h e a c t u a l b a t t e r y l e v e l c a n b e s e e n f r o m t h e V o l t a g e c o l u m n

T i m e L e f t T h i s s h o w s t h e t i m e r e m a i n i n g u n t i l t h e b a t t e r y i s e m p t y , a g a i n a s e s t i m a t e d

b y R o c k b o x .

V o l t a g e T h e b a t t e r y v o l t a g e i n m V a t t h e m o m e n t t h e m e a s u r e m e n t w a s t a k e n .

C T h i s s t a n d s f o r C h a r g e r . A n A i n t h a t c o l u m n s h o w s i f t h e p o w e r a d a p t e r w a s

a t t a c h e d t o t h e u n i t a t t h e t i m e o f t h e m e a s u r e m e n t .

U U S B p o w e r e d . O n l y f o r t a r g e t s t h a t s u p p o r t t h i s . A U w i l l i n d i c a t e i f t h e u n i t w a s

u s i n g t h e U S B p o r t f o r p o w e r a t t h e t i m e o f t h e m e a s u r e m e n t .

U s a g e

T h e l o g l e c a n b e u s e d t o t e l l y o u h o w l o n g t h e b a t t e r y l a s t e d ( w i t h s o m e l i m i t a t i o n s , s e e

b e l o w ) , b u t i t i s m o s t u s e f u l f o r g r a p h i n g d i s c h a r g e c u r v e s i n o r d e r t o i m p r o v e R o c k b o x ' s

e s t i m a t i o n o f b a t t e r y l e v e l a n d t i m e r e m a i n i n g . T h e b a t t e r y l o g ( b a t t e r y _ b e n c h . t x t )

i s i n C S V f o r m a t ( c o m m a s e p a r a t e d v a r i a b l e s ) a n d t h u s c a n b e e a s i l y i m p o r t e d i n t o a

s p r e a d s h e e t o r s i m i l a r p r o g r a m .

L i m i t a t i o n s

A s B a t t e r y B e n c h m a r k n e e d s t o w r i t e t h e d a t a h e l d i n m e m o r y t o d i s k i n o r d e r t o

s a v e t h e m , i t i s p o s s i b l e t h a t s h o u l d R o c k b o x s h u t d o w n d u e t o l o w b a t t e r y t h e n t h e r e

w i l l n o t b e e n o u g h p o w e r r e m a i n i n g t o w r i t e t h e d a t a t o d i s k . T h e r e f o r e a l l m e a s u r e m e n t s

s i n c e t h e p r e v i o u s s a v e w i l l b e l o s t .




C h a p t e r 1 0 . P l u g i n s 1 4 9

1 0 . 4 . 3 . C a l c u l a t o r

F i g u r e 1 0 . 4 8 . : C a l c u l a t o r

T h i s i s a s i m p l e s c i e n t i c c a l c u l a t o r f o r u s e o n t h e p l a y e r . I t w o r k s l i k e a s t a n d a r d

c a l c u l a t o r . P r e s s i n g t h e 1 s t a n d 2 n d b u t t o n s w i l l t o g g l e b e t w e e n o t h e r a v a i l a b l e

m a t h f u n c t i o n s .



U p / D o w n

M o v e a r o u n d t h e k e y p a d

S e l e c t S e l e c t a b u t t o n

A D e l e t e l a s t e n t e r e d d i g i t o r c l e a r a f t e r c a l -

c u l a t i o n

M e n u C a l c u l a t e

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 5 0

1 0 . 4 . 4 . C a l e n d a r

F i g u r e 1 0 . 4 9 . : C a l e n d a r

T h i s i s a s m a l l a n d s i m p l e c a l e n d a r a p p l i c a t i o n w i t h m e m o s a v i n g f u n c t i o n . D o t s i n d i c a t e

d a t e s w i t h m e m o s . T h e a v a i l a b l e m e m o t y p e s a r e : o n e o , y e a r l y , m o n t h l y , a n d w e e k l y

m e m o s .

Y o u c a n s e l e c t w h a t d a y i s r s t d a y o f w e e k b y t h e s e t t i n g F i r s t D a y o f W e e k i n

t h e m e n u .



U p / D o w n

M o v e t h e s e l e c t o r

S e l e c t S h o w m e m o s f o r t h e s e l e c t e d d a y

V o l u m e u p /

V o l u m e d o w n

P r e v i o u s / N e x t m o n t h

P o w e r Q u i t




C h a p t e r 1 0 . P l u g i n s 1 5 1

1 0 . 4 . 5 . C h e s s C l o c k

F i g u r e 1 0 . 5 0 . : C h e s s C l o c k

T h e c h e s s c l o c k p l u g i n i s d e s i g n e d t o s i m u l a t e a c h e s s c l o c k , b u t i t c a n b e u s e d i n a n y

k i n d o f g a m e w i t h u p t o t e n p l a y e r s .

S e t u p


U p / D o w n I n c r e a s e / d e c r e a s e d i s p l a y e d V a l u e

S e l e c t M o v e t o n e x t s c r e e n

P o w e r M o v e t o p r e v i o u s s c r e e n

• F i r s t e n t e r t h e n u m b e r o f p l a y e r s ( 1 1 0 )

• T h e n s e t t h e t o t a l g a m e t i m e i n m m : s s

• T h e n t h e m a x i m u m r o u n d t i m e i s e n t e r e d . F o r e x a m p l e , t h i s c o u l d b e u s e d t o p l a y

S c r a b b l e f o r a m a x i m u m o f 1 5 m i n u t e s e a c h , w i t h e a c h r o u n d t a k i n g n o l o n g e r t h a n

o n e m i n u t e .

• D o n e . P l a y e r 1 s t a r t s i n p a u s e d m o d e .




C h a p t e r 1 0 . P l u g i n s 1 5 2

W h i l e p l a y i n g

T h e n u m b e r o f t h e c u r r e n t p l a y e r i s d i s p l a y e d o n t h e t o p l i n e . T h e t i m e b e l o w i s t h e

t i m e r e m a i n i n g f o r t h a t r o u n d ( a n d p o s s i b l y a l s o t h e t o t a l t i m e l e f t i f d i e r e n t ) .

K e y s a r e a s f o l l o w s :


P o w e r E x i t p l u g i n

A R e s t a r t r o u n d f o r t h e c u r r e n t p l a y e r

S e l e c t P a u s e t h e t i m e ( p r e s s a g a i n t o c o n t i n u e )

U p S w i t c h t o n e x t p l a y e r

D o w n S w i t c h t o p r e v i o u s p l a y e r

M e n u O p e n m e n u ( S e l e c t t o s e l e c t . )

F r o m t h e m e n u i t i s p o s s i b l e t o d e l e t e a p l a y e r , m o d i f y t h e r o u n d t i m e f o r t h e c u r r e n t

p l a y e r o r s e t t h e t o t a l t i m e f o r t h e g a m e . W h e n t h e r o u n d t i m e i s u p f o r a p l a y e r t h e

m e s s a g e R O U N D U P ! i s s h o w n ( p r e s s N E X T t o c o n t i n u e ) . W h e n t h e t o t a l t i m e i s u p

f o r a p l a y e r t h e m e s s a g e T I M E U P ! i s s h o w n . T h e p l a y e r w i l l t h e n b e r e m o v e d f r o m t h e

t i m e r .

1 0 . 4 . 6 . C l o c k

F i g u r e 1 0 . 5 1 . : C l o c k




C h a p t e r 1 0 . P l u g i n s 1 5 3

T h i s i s a f u l l y f e a t u r e d a n a l o g u e a n d d i g i t a l c l o c k p l u g i n .

K e y c o n g u r a t i o n



/ V o l u m e U p

C y c l e t h r o u g h m o d e s


R e w i n d

C y c l e t h r o u g h s k i n s

P o w e r M a i n M e n u

S e l e c t S t a r t / S t o p C o u n t e r

L o n g S e l e c t R e s e t C o u n t e r

C l o c k M e n u

V i e w C l o c k E x i t s t h e m e n u a n d r e t u r n s t o t h e c u r r e n t c l o c k m o d e d i s p l a y .

M o d e S e l e c t o r O p e n s a m e n u f r o m w h i c h y o u c a n s e l e c t a c l o c k m o d e t o v i e w .

C o u n t e r S e t t i n g s O p e n s a m e n u f r o m w h i c h y o u c a n a d j u s t s e t t i n g s p e r t a i n i n g t o t h e

c o u n t e r .

M o d e S e t t i n g s O p e n s a m e n u f r o m w h i c h y o u c a n a d j u s t s e t t i n g s p e r t a i n i n g t o t h e

c u r r e n t c l o c k m o d e ( a n a l o g , d i g i t a l , b i n a r y ) .

G e n e r a l S e t t i n g s R e s e t S e t t i n g s R e s e t a l l s e t t i n g s t o t h e i r d e f a u l t v a l u e s .

S a v e S e t t i n g s S a v e a l l s e t t i n g s t o d i s k .

S h o w C o u n t e r T o g g l e C o u n t e r d i s p l a y .

S a v e C h o o s e w h e t h e r t o d i s a b l e a u t o m a t i c s a v i n g , s a v i n g t o d i s k o n e x i t , o r s a v i n g

t o d i s k e v e r y s e t t i n g s c h a n g e .

B a c k l i g h t C h o o s e w h e t h e r t o d i s a b l e t h e b a c k l i g h t , u s e t h e u s e r ' s t i m e o u t s e t t i n g ,

o r k e e p t h e b a c k l i g h t o n .

I d l e P o w e r o T o g g l e I d l e P o w e r o .

N o t e : T h i s s e t t i n g i s n o t s a v e d t o d i s k . bH e l p O p e n s a b r i e f h e l p s c r e e n w i t h k e y m a p p i n g s a n d f u n c t i o n a l i t y .

C r e d i t s D i s p l a y s a c r e d i t s r o l l .




C h a p t e r 1 0 . P l u g i n s 1 5 4

A n a l o g m o d e

S m a l l , r o u n d , a n a l o g c l o c k i s d i s p l a y e d i n t h e m i d d l e o f t h e L C D . T i m e r e a d o u t , i f

e n a b l e d , i s d i s p l a y e d a t t h e u p p e r l e f t . I f T i m e r e a d o u t i s i n 1 2 - h o u r ( 1 2 h ) m o d e , A M

o r P M w i l l b e d i s p l a y e d a t t h e u p p e r r i g h t . T h e D a t e r e a d o u t , i f e n a b l e d , i s d i s p l a y e d a t

t h e l o w e r l e f t . T h e C o u n t e r , i f e n a b l e d , i s d i s p l a y e d a t t h e l o w e r r i g h t . T h e s e c o n d h a n d ,

i f e n a b l e d , i s d i s p l a y e d a l o n g w i t h t h e h o u r a n d m i n u t e h a n d s . D i g i t d i s p l a y , i f e n a b l e d ,

p l a c e s 1 2 , 3 , 6 , a n d 9 a r o u n d t h e f a c e o f t h e c l o c k i n t h e i r r e s p e c t i v e p o s i t i o n s .

D i g i t a l m o d e

A n i m i t a t i o n o f a n L C D , t h i s m o d e s h o w s a C l o c k c o m p r i s e d o f d i g i t a l s e g m e n t s . T h e

D a t e r e a d o u t , i f e n a b l e d , i s d i s p l a y e d a t t h e b o t t o m , c e n t e r . T h e S e c o n d r e a d o u t , i f i n

T e x t m o d e , i s d i s p l a y e d a t t h e t o p , c e n t e r ; i f i n B a r m o d e , i s d i s p l a y e d a s a p r o g r e s s

b a r a t t h e t o p o f t h e L C D ; i f i n I n v e r t m o d e , w i l l i n v e r t t h e L C D l e f t - t o - r i g h t a s t h e

s e c o n d s p a s s ( a f u l l y - i n v e r t e d L C D m e a n s t h e e n t i r e m i n u t e h a s p a s s e d ) . T h e C o u n t e r ,

i f d i s p l a y e d , i s s h o w n a t t h e u p p e r l e f t . T h e B l i n k i n g C o l o n , i f e n a b l e d , b l i n k s t h e c o l o n

o n c e e v e r y s e c o n d . 1 2 - h o u r m o d e , i f e n a b l e d , w i l l d i s p l a y t h e t i m e i n a 1 2 - h o u r f o r m a t .

L C D m o d e

B a s e d o n t h e D i g i t a l M o d e , t h e L C D m o d e i s a n o t h e r i m i t a t i o n o f a n L C D . T h e s e t t i n g s

a v a i l a b l e i n t h i s m o d e a r e e x a c t l y t h e s a m e a s D i g i t a l M o d e , b u t t h e y a r e i n d e p e n d e n t

o f D i g i t a l M o d e . F o r e x a m p l e , y o u c a n h a v e t h e D a t e R e a d o u t e n a b l e d i n D i g i t a l M o d e

a n d d i s a b l e d i n L C D M o d e .

F u l l s c r e e n

A F u l l s c r e e n c l o c k i s d i s p l a y e d . S h o w B o r d e r , i f e n a b l e d , w i l l d r a w a s m a l l b o x a t e v e r y

h o u r p o s i t i o n ( 1 t o 1 2 i n c l u s i v e ) . I n v e r t S e c o n d s , i f e n a b l e d , w i l l i n v e r t t h e L C D a s t h e

s e c o n d s p a s s . S e c o n d H a n d , i f e n a b l e d , w i l l d r a w a s e c o n d h a n d a m o n g t h e h o u r a n d

m i n u t e h a n d s .

B i n a r y m o d e

T h i s m o d e s h o w s a B i n a r y c l o c k . T h e h o u r i s d i s p l a y e d o n t h e t o p l i n e , t h e m i n u t e

i s d i s p l a y e d o n t h e m i d d l e l i n e , a n d t h e s e c o n d s a r e o n t h e l a s t l i n e . C i r c l e m o d e , i f

e n a b l e d , d r a w s e m p t y a n d f u l l c i r c l e s , i n s t e a d o f z e r o s a n d o n e s . F o r h e l p o n r e a d i n g

b i n a r y , p l e a s e v i s i t : h t t p : / / e n . w i k i p e d i a . o r g / w i k i / B i n a r y _ n u m e r a l _ s y s t e m

P l a i n m o d e

T h i s m o d e s h o w s a p l a i n c l o c k i n l a r g e t e x t t h a t t a k e s u p n e a r l y t h e w h o l e L C D .


http://en.wikipedia.org/wiki/Binary_numeral_system



C h a p t e r 1 0 . P l u g i n s 1 5 5

1 0 . 4 . 7 . D i s k T i d y

D i s k T i d y d e l e t e s j u n k l e s c o m m o n l y l e f t b e h i n d b y W i n d o w s , L i n u x a n d O S X a f t e r

c o n n e c t i n g y o u r p l a y e r o v e r U S B . S e l e c t t h e l e s y o u w a n t t o d e l e t e i n t h e F i l e s t o

C l e a n m e n u a n d s e l e c t S t a r t C l e a n i n g t o b e g i n t h e p r o c e s s . T h e s e t t i n g s a r e s t o r e d

i n t h e p l a i n t e x t l e . r o c k b o x / r o c k s / a p p s / d i s k t i d y . c o n f i g t h a t i s u s e r - m o d i a b l e t o

a l l o w c u s t o m e n t r i e s t o b e a d d e d .

T h e a s t e r i s k c h a r a c t e r ( * ) c a n b e u s e d a s a w i l d - c a r d w h i c h w i l l m a t c h a n y s t r i n g ;

h o w e v e r o n l y t h e r s t a s t e r i s k w i l l b e r e c o g n i s e d a s a w i l d - c a r d w i t h a n y a d d i t i o n a l u s e s

b e i n g t a k e n a s l i t e r a l .

W a r n i n g : B e c a r e f u l w h e n y o u u s e c u s t o m e n t r i e s a s y o u c o u l d a c c i d e n t a l l y d e l e t e !i m p o r t a n t l e s .

A v a i l a b l e O p t i o n s

A l l s e l e c t s a l l L i n u x , O S X , a n d W i n d o w s l e s .

N o n e d e s e l e c t s a l l l e o p t i o n s .

L i n u x s e l e c t s L i n u x l e s . D e f a u l t l e s a r e . d o l p h i n v i e w , . d 3 l p h i n v i e w , a n d . T r a s h - * / .

W i n d o w s s e l e c t s W i n d o w s l e s . D e f a u l t l e s a r e T h u m b s . d b , $ R E C Y C L E . B I N / , D e s k t o p . i n i ,

R e c y c l e d / a n d S y s t e m V o l u m e I n f o r m a t i o n / .

M a c s e l e c t s O S X l e s . D e f a u l t l e s a r e . _ * , . D S _ S t o r e , . S p o t l i g h t - V 1 0 0 / a n d . T r a s h e s / .

O t h e r s e l e c t s a d d i t i o n a l l e s a d d e d t o t h e c o n g u r a t i o n l e b y t h e u s e r .


L e f t o r P o w e r R e w i n d E x i t / A b o r t

1 0 . 4 . 8 . K e y b o x

K e y b o x i s a n e n c r y p t e d p a s s w o r d s t o r a g e u s i n g t h e T i n y E n c r y p t i o n A l g o r i t h m w i t h a

k e y d e r i v e d u s i n g m d 5 .

U s i n g K e y b o x

T o g e t s t a r t e d , s t a r t u p t h e p l u g i n a n d s e l e c t E n t e r K e y b o x . T h e r s t t i m e y o u e n t e r

K e y b o x y o u w i l l b e p r o m p t e d f o r a m a s t e r p a s s w o r d a n d f o r c o n r m a t i o n o f t h e m a s t e r

p a s s w o r d . T h e m a s t e r p a s s w o r d i s t h e p a s s w o r d t h a t y o u m u s t u s e t o a c c e s s y o u r s t o r e d

p a s s w o r d s .




C h a p t e r 1 0 . P l u g i n s 1 5 6

O n c e i n s i d e , e n t e r t h e c o n t e x t m e n u b y p r e s s i n g L o n g S e l e c t . F r o m t h e c o n t e x t m e n u

y o u c a n c r e a t e n e w e n t r i e s , d e l e t e e n t r i e s a n d e d i t e n t r i e s . E a c h e n t r y h a s a t i t l e , a

u s e r n a m e a n d a p a s s w o r d .

S e l e c t i n g R e s e t K e y b o x f r o m t h e m a i n m e n u w i l l d e l e t e t h e c u r r e n t l i s t o f p a s s w o r d s

a n d a n e w , e m p t y l i s t w i l l b e c r e a t e d t h e n e x t t i m e y o u s e l e c t E n t e r K e y b o x a f t e r

p r o m p t i n g f o r a n e w m a s t e r p a s s w o r d . E n t r i e s a r e a u t o m a t i c a l l y s a v e d w h e n t h e p l u g i n

i s e x i t e d .

1 0 . 4 . 9 . L a m p

L a m p i s a s i m p l e p l u g i n t o u s e y o u r p l a y e r a s a l a m p ( a s h l i g h t , t o r c h ) . Y o u g e t a n

e m p t y s c r e e n w i t h m a x i m u m b r i g h t n e s s .


L e f t / R i g h t T o g g l e b e t w e e n c o l o u r s

D o w n / U p C h a n g e t h e b r i g h t n e s s

A n y o t h e r k e y Q u i t

1 0 . 4 . 1 0 . L r c p l a y e r

T h i s p l u g i n d i s p l a y s l y r i c s i n . l r c l e s ( a n d s o m e o t h e r f o r m a t s ) s y n c h r o n i z e d w i t h t h e

s o n g b e i n g p l a y e d .

S u p p o r t e d l e t y p e s

1 . . l r c

2 . . l r c 8

3 . . s n c

4 . . t x t

5 . i d 3 v 2 S Y L T o r U S L T t a g s i n m p 3 l e s

. l r c 8 l e s a r e t h e s a m e a s . l r c l e s e x c e p t t h a t t h e y a r e U T F 8 e n c o d e d . T h e L y r i c s 3

t a g i s n o t s u p p o r t e d .

S u p p o r t e d t a g s a n d f o r m a t s f o r . l r c l e s

T h e f o l l o w i n g t a g s a r e s u p p o r t e d :

[ t i : t i t l e ]

[ a r : a r t i s t ]

[ o f f s e t : o f f s e t ( m s e c ) ]




C h a p t e r 1 0 . P l u g i n s 1 5 7

E a c h l i n e s h o u l d r e s e m b l e o n e o f t h e f o l l o w i n g :

[ t i m e t a g ] l i n e

[ t i m e t a g ] . . . [ t i m e t a g ] l i n e

[ t i m e t a g ] < w o r d t i m e t a g > w o r d < w o r d t i m e t a g > . . . < w o r d t i m e t a g >

T h e t i m e t a g m u s t b e i n t h e f o r m [ m m : s s ] , [ m m : s s . x x ] , o r [ m m : s s . x x x ] w h e r e m m i s

m i n u t e s , s s i s s e c o n d s , x x i s t e n t h o f m i l l i s e c o n d s , a n d x x x i s m i l l i s e c o n d s . A n y o t h e r

t a g s a n d l i n e s w i t h o u t t i m e t a g s a r e i g n o r e d .

L o c a t i o n o f l y r i c s l e s

T h e p l u g i n c h e c k s t h e f o l l o w i n g d i r e c t o r i e s f o r l y r i c s l e s . I f n o l y r i c s l e i s f o u n d a n d

t h e a u d i o l e i s a . m p 3 , i t a l s o c h e c k s f o r S Y L T a n d U S L T t a g s i n t h e i d 3 v 2 t a g s .

1 . T h e d i r e c t o r y c o n t a i n i n g t h e a u d i o l e a n d i t s p a r e n t d i r e c t o r i e s .

2 . F o r e a c h o f t h e a b o v e d i r e c t o r i e s , t h e p l u g i n s e a r c h e s f o r a s u b d i r e c t o r y n a m e d

L y r i c s .

3 . F i n a l l y , t h e p l u g i n w i l l s e a r c h a s a b o v e , b u t w i t h i n a d i r e c t o r y c a l l e d / L y r i c s .

T h e n a m e o f t h i s d i r e c t o r y c a n b e c u s t o m i z e d , s e e b e l o w .

I f t h e a u d i o l e c u r r e n t l y p l a y i n g i s / M u s i c / A r t i s t / A l b u m / T i t l e . m p 3 , t h e n t h e f o l -

l o w i n g l e s w i l l b e s e a r c h e d f o r , i n t h i s o r d e r . . e x t i s o n e o f t h e s u p p o r t e d e x t e n s i o n s

f r o m t h e l i s t a b o v e , a n d w i l l b e s e a r c h e d f o r i n t h e s a m e o r d e r a s i n t h a t l i s t .

/ M u s i c / A r t i s t / A l b u m / T i t l e . e x t

/ M u s i c / A r t i s t / T i t l e . e x t

/ M u s i c / T i t l e . e x t

/ T i t l e . e x t

/ M u s i c / A r t i s t / A l b u m / L y r i c s / T i t l e . e x t

/ M u s i c / A r t i s t / L y r i c s / T i t l e . e x t

/ M u s i c / L y r i c s / T i t l e . e x t

/ L y r i c s / T i t l e . e x t

/ L y r i c s / M u s i c s / A r t i s t / A l b u m / T i t l e . e x t

/ L y r i c s / M u s i c s / A r t i s t / T i t l e . e x t

/ L y r i c s / M u s i c s / T i t l e . e x t

/ L y r i c s / T i t l e . e x t




C h a p t e r 1 0 . P l u g i n s 1 5 8

C o n t r o l s



V o l u m e D o w n

V o l u m e u p / d o w n .

L e f t R e w i n d G o t o b e g i n n i n g o f t r a c k , o r i f p r e s s e d

w h i l e i n t h e r s t s e c o n d s o f a t r a c k , g o t o

t h e p r e v i o u s t r a c k .

L o n g L e f t L o n g R e w i n d R e w i n d i n t r a c k .

R i g h t F o r w a r d G o t o t h e n e x t t r a c k .

L o n g R i g h t L o n g F o r w a r d F a s t f o r w a r d i n t r a c k .

A P l a y T o g g l e p l a y / p a u s e .

P o w e r o r S e l e c t L o n g P l a y o r E x i t t h e p l u g i n .

L o n g S e l e c t L o n g M e n u E n t e r t i m e t a g e d i t o r .

M e n u M e n u E n t e r L r c p l a y e r M e n u .

L r c p l a y e r M e n u

T h e m e s e t t i n g s . C h a n g e t h e m e r e l a t e d s e t t i n g s .

S h o w S t a t u s b a r . S h o w / h i d e t h e s t a t u s b a r .

D i s p l a y T i t l e . S h o w / h i d e t h e t r a c k t i t l e .

D i s p l a y T i m e . S h o w / h i d e t h e c u r r e n t t i m e .

I n a c t i v e C o l o u r . S e t t h e c o l o u r o f t h e i n a c t i v e p a r t o f t h e l y r i c s .

B a c k l i g h t F o r c e O n . D o n o t t u r n o t h e b a c k l i g h t w h i l e d i s p l a y i n g t h e l y r i c s .

D i s p l a y S e t t i n g s . C h a n g e h o w t h e l y r i c s a r e d i s p l a y e d .

W r a p . B r e a k s l i n e s a t w h i t e s p a c e .

W i p e . W i p e s t h e t e x t .

A l i g n m e n t . A l i g n t e x t t o t h e l e f t , c e n t r e , o r r i g h t .

A c t i v a t e O n l y C u r r e n t L i n e . A c t i v a t e o n l y t h e c u r r e n t l i n e , o r t h e c u r r e n t a n d

p r e v i o u s l i n e s .

L y r i c s S e t t i n g s . C h a n g e h o w t h e l y r i c s l e s a r e l o a d e d .

E n c o d i n g . S e t s t h e c o d e p a g e u s e d i n t h e p l u g i n .

R e a d I D 3 t a g . R e a d l y r i c s f r o m i d 3 t a g s i n m p 3 l e s .

L r c D i r e c t o r y . S e t t h e d i r e c t o r y w h e r e l y r i c s l e s a r e s t o r e d , m u s t b e a m a x i m u m

o f 6 3 b y t e s .




C h a p t e r 1 0 . P l u g i n s 1 5 9

P l a y b a c k C o n t r o l . S h o w t h e p l a y b a c k c o n t r o l m e n u .

T i m e O s e t . S e t a n o s e t f o r t h e t i m e t a g s f o r t h e l y r i c s c u r r e n t l y i n u s e .

T i m e t a g E d i t o r . E n t e r t h e t i m e t a g e d i t o r .

Q u i t . E x i t t h e p l u g i n .

E d i t i n g t h e t i m e t a g s

T h e d i s p l a y t i m e f o r e a c h l i n e c a n b e c h a n g e d w i t h t h e t i m e t a g e d i t o r . S e l e c t i n g a l i n e

c h a n g e s i t s t i m e t o t h e c u r r e n t p o s i t i o n o f t h e t r a c k . T o s e t a s p e c i c t i m e o r t o a d j u s t

t h e t i m e , p r e s s L o n g S e l e c t t o b r i n g u p a s c r e e n t o a d j u s t t h e t i m e . C h a n g e s w i l l b e

s a v e d a u t o m a t i c a l l y w h e n t h e s o n g i s c h a n g e d . E d t i n g w o r d s i n l y r i c s i s n o t s u p p o r t e d .

1 0 . 4 . 1 1 . m d 5 s u m

O p e n a l e , a d i r e c t o r y o r j u s t l a u n c h i t f r o m t h e p l u g i n m e n u t o c r e a t e a n m d 5 s u m o f

t h e l e , t h e d i r e c t o r y ' s c o n t e n t s o r t h e w h o l e l e s y s t e m . I f t h e l e ' s e x t e n s i o n i s . m d 5 o r

. m d 5 s u m , i t w i l l c h e c k t h e m d 5 s u m s i n t h e l e i n s t e a d . I f t h e l e ' s e x t e n s i o n i s . m d 5 l i s t

i t w i l l c o m p u t e m d 5 s u m s f o r a l l t h e l e s l i s t e d .

1 0 . 4 . 1 2 . M e t r o n o m e

T h i s p l u g i n c a n b e u s e d a s a m e t r o n o m e t o k e e p t i m e d u r i n g m u s i c p r a c t i c e . A d j u s t t h e

t e m p o t h r o u g h t h e i n t e r f a c e o r b y t a p p i n g i t o u t o n t h e a p p r o p r i a t e b u t t o n .


L o n g P o w e r E x i t p l u g i n

P o w e r S t a r t / S t o p

S e l e c t T a p t e m p o


/ V o l u m e U p

A d j u s t t e m p o


R e w i n d

A d j u s t v o l u m e

1 0 . 4 . 1 3 . R a n d o m F o l d e r A d v a n c e C o n g u r a t i o n

T h i s p l u g i n i s u s e d t o c o n g u r e t h e f o l d e r s w h i c h w i l l b e c o n s i d e r e d w h e n t h e A u t o -

C h a n g e D i r e c t o r y f e a t u r e i s s e t t o R a n d o m .




C h a p t e r 1 0 . P l u g i n s 1 6 0

M e n u

G e n e r a t e F o l d e r L i s t G e n e r a t e s a l i s t o f a l l f o l d e r s f o u n d o n t h e p l a y e r . Y o u c a n l t e r

t h e d i r e c t o r i e s w h i c h a r e s c a n n e d b y c r e a t i n g a l e c a l l e d

/ . r o c k b o x / f o l d e r _ a d v a n c e _ d i r . t x t . O n l y t h e d i r e c t o r i e s i n t h i s l e a n d a n y

c o n t a i n e d d i r e c t o r i e s w i l l b e s c a n n e d . Y o u c a n h a v e u p t o 1 0 d i r e c t o r i e s i g n o r e d

b y t h e s c a n b y p l a c i n g a m i n u s s i g n b e f o r e t h e m i n t h e l i s t ( i . e . - / C D s w i l l c a u s e

e v e r y t h i n g i n t h e / C D s d i r e c t o r y t o b e i g n o r e d . ) . I f y o u j u s t w a n t / C D s t o b e i g n o r e d

b u t w a n t t o i n c l u d e t h e f o l d e r s w i t h i n i t y o u n e e d t o h a v e b o t h - / C D s a n d C D s a s

e n t r i e s .

E d i t F o l d e r L i s t E n t e r t h e f o l d e r l i s t e d i t o r

E x p o r t L i s t T o T e x t l e E x p o r t s t h e l i s t t o / . r o c k b o x / f o l d e r _ a d v a n c e _ l i s t . t x t

I m p o r t L i s t F r o m T e x t l e I m p o r t s t h e l i s t f r o m / . r o c k b o x / f o l d e r _ a d v a n c e _ l i s t . t x t

P l a y S h u e d S t a r t s p l a y b a c k w i t h t h e s e l e c t e d d i r e c t o r i e s i n r a n d o m o r d e r . T r a c k s

w i t h i n a d i r e c t o r y w i l l b e p l a y e d i n n o r m a l o r d e r . T h e p l u g i n w i l l e x i t a f t e r s t a r t i n g

p l a y b a c k .

Q u i t

F o l d e r L i s t E d i t o r K e y s


S e l e c t o r R i g h t F o r w a r d D e l e t e s e l e c t e d f o l d e r

L o n g S e l e c t L o n g M e n u B r i n g u p t h e c o n t e x t m e n u w h i c h a l l o w s

y o u t o r e m o v e t h e s e l e c t e d f o l d e r o r i t ' s

e n t i r e f o l d e r t r e e

L e f t o r P o w e r R e w i n d E x i t

1 0 . 4 . 1 4 . R e s i s t o r C a l c u l a t o r

W A R N I N G ! I m a g e n o t f o u n d

F i g u r e 1 0 . 5 2 . : R e s i s t o r c a l c u l a t o r

T h e r e s i s t o r c a l c u l a t o r i s a p l u g i n t h a t w o r k s i n 3 m o d e s :

C o l o u r t o R e s i s t a n c e

I n C o l o u r t o R e s i s t a n c e m o d e , u s e t h e m e n u s t o s e l e c t t h e c o l o u r s o f t h e b a n d s o f a

r e s i s t o r w h i c h y o u w o u l d l i k e t o k n o w t h e r e s i s t a n c e o f .




C h a p t e r 1 0 . P l u g i n s 1 6 1

R e s i s t a n c e t o C o l o u r

I n R e s i s t a n c e t o C o l o u r m o d e , u s e t h e m e n u s t o s e l e c t t h e u n i t t h a t y o u w o u l d l i k e t o

u s e ( c h o o s e f r o m O h m s , K i l o o h m s , M e g a o h m s ) , a n d u s e t h e o n - s c r e e n k e y b o a r d t o i n p u t

t h e v a l u e o f t h e r e s i s t o r t h a t y o u w o u l d l i k e t o k n o w t h e c o l o u r c o d e o f . T h e c o l o u r c o d e s

a r e p r e s e n t e d g r a p h i c a l l y a n d t e x t u a l l y .

L E D r e s i s t a n c e

L E D r e s i s t a n c e c a l c u l a t o r i s u s e d t o d e t e r m i n e t h e r e s i s t o r n e c e s s a r y t o l i g h t a n L E D

s a f e l y a t a g i v e n v o l t a g e . F i r s t , s e l e c t t h e v o l t a g e t h a t t h e L E D w i l l u s e ( t h e r s t o p t i o n

i s t h e m o s t c o m m o n a n d a s a f e b e t ) , a n d t h e c u r r e n t t h a t i t w i l l d r a w ( l i k e w i s e w i t h

t h e r s t o p t i o n ) . T h e n , u s e t h e o n s c r e e n k e y b o a r d t o t y p e i n t h e s u p p l y v o l t a g e a n d ,

i f s e l e c t e d , t h e c u s t o m f o r e w a r d c u r r e n t . T h i s f u n c t i o n p r o d u c e s s a f e e s t i m a t e s , b u t

u s e y o u r o w n j u d g e m e n t w h e n u s i n g t h e s e o u t p u t v a l u e s . P o w e r r a t i n g a n d d i s p l a y e d

r e s i s t a n c e a r e r o u n d e d u p t o t h e n e a r e s t c o m m o n v a l u e .

1 0 . 4 . 1 5 . R o c k p a i n t

F i g u r e 1 0 . 5 3 . : R o c k p a i n t

R o c k p a i n t i s a b i t m a p ( . b m p

) e d i t o r f o r R o c k b o x . I t c a n o p e n a n y . b m p

l e w h o s e d i -

m e n s i o n s a r e t h e s a m e s i z e a s y o u r d e v i c e ' s s c r e e n o r s m a l l e r ; i t c a n a l s o c r e a t e e m p t y

b i t m a p s f o r y o u t o w o r k w i t h .




C h a p t e r 1 0 . P l u g i n s 1 6 2

O p e n i n g A F i l e

T o o p e n a l e , y o u m a y u s e e i t h e r t h e c o n t e x t m e n u o p t i o n O p e n W i t h i n t h e F i l e

B r o w s e r , o r y o u m a y e n t e r R o c k p a i n t r s t u s i n g t h e P l u g i n s m e n u a n d o p e n a l e f r o m

t h e r e . T o p e r f o r m t h e l a t t e r , s i m p l y p r e s s R o c k p a i n t ' s M e n u b u t t o n o r m o v e t h e c u r s o r

b e y o n d t h e b o t t o m o f t h e s c r e e n ; t h e n m o v e t h e c u r s o r o n t o M e n u a n d s e l e c t i t . F i n a l l y ,

s e l e c t L o a d a n d n a v i g a t e t o t h e i m a g e y o u w i s h t o o p e n .

T o o l s

R o c k p a i n t o e r s s e v e r a l t o o l s t o a i d y o u i n e d i t i n g ; y o u c a n v i e w t h e m b y e i t h e r p r e s s i n g

R o c k p a i n t ' s M e n u k e y o r b y a t t e m p t i n g t o m o v e t h e c u r s o r b e y o n d t h e b o t t o m o f t h e

s c r e e n . F r o m t o p t o b o t t o m a n d l e f t t o r i g h t , a n d b y s e c t i o n , t h e y a r e a s f o l l o w s :

C o l o u r P i c k e r T h e t o p l e f t t o o l s h o w s y o u r c o l o u r s t h a t a r e a t t h e r e a d y . T o s w a p t h e m ,

c l i c k o n t h e b a c k g r o u n d c o l o u r . T o e d i t t h e f o r e g r o u n d c o l o u r , c l i c k o n i t .

P r e s e t P a l l e t e S e v e r a l p r e s e t c o l o u r s a r e a v a i l i b l e . C l i c k i n g o n o n e c h a n g e s t h e f o r e -

g r o u n d o f t h e C o l o u r P i c k e r t o t h e s e l e c t e d c o l o u r .

P e n c i l D r a w s a s y o u m o v e t h e c u r s o r . Y o u c a n c h a n g e t h e b r u s h s i z e w i t h t h e M e n u

o p t i o n B r u s h S i z e . U s e t h e S e l e c t k e y t o t o g g l e t h e t o o l w h i l e e d i t i n g t h e i m a g e .

S e l e c t i o n t o o l A l l o w s y o u t o s e l e c t a r e c t a n g u l a r r e g i o n ; o n c e y o u d o , y o u w i l l b e s h o w n

a m e n u o f o p t i o n s ( i n c l u d i n g c a n c e l i f y o u m a k e a m i s t a k e ) .

L i n e t o o l D r a w s a s t r a i g h t l i n e .

C u r v e t o o l A l l o w s y o u t o d r a w a l i n e a n d c u r v e i t .

R e c t a n g l e t o o l D r a w s a n u n l l e d r e c t a n g l e .

C i r c l e t o o l D r a w s a n u n l l e d c i r c l e .

G r a d i e n t l l T o u s e t h i s t o o l , c l i c k a t t h e s t a r t i n g a n d e n d i n g p o i n t s . S t a r t i n g w i t h t h e

b a c k g r o u n d a n d g o i n g t o t h e f o r e g r o u n d c o l o u r , R o c k p a i n t w i l l l l t h e r e g i o n w i t h

a g r a d u a l c o l o u r c h a n g e .

B u c k e t l l F i l l s a n s a m e - c o l o u r o r e m p t y r e g i o n w i t h a c o l o u r .

D r o p p e r C l i c k o n a c o l o u r i n t h e i m a g e t o c h a n g e t h e f o r e g r o u n d c o l o u r t o i t .

E r a s e r T h e o p p o s i t e o f t h e p e n c i l ; i t c h a n g e s p a i n t e d p i x e l s t o w h i t e .

T e x t t o o l D r a w s t e x t o n t h e i m a g e .

F i l l e d r e c t a n g l e S a m e a s t h e R e c t a n g l e t o o l , b u t l l s i t w i t h c o l o u r .

F i l l e d c i r c l e S a m e a s t h e C i r c l e t o o l , b u t l l s i t w i t h c o l o u r .




C h a p t e r 1 0 . P l u g i n s 1 6 3

C u r v e d G r a d i e n t F i l l S a m e a s G r a d i e n t l l , b u t y o u m u s t d r a w t w o l i n e s . R o c k p a i n t

w i l l d r a w a c u r v e d , g r a d u a l c h a n g e o f c o l o u r i n t h e r e g i o n .

M e n u T h i s o p e n s t h e M a i n M e n u . Y o u c a n a l s o p r e s s t h e M e n u k e y t o o p e n i t .

M a i n M e n u

T h e m a i n m e n u c o n s i s t s o f t h e f o l l o w i n g :

R e s u m e C l o s e s t h e M a i n M e n u .

N e w C r e a t e s a n e w c a n v a s a n d d i s c a r d s t h e c u r r e n t l e . B E C A R E F U L . Y o u w i l l l o s e

a n y u n s a v e d c h a n g e s i n t h e l e t h a t i s c u r r e n t l y o p e n .

L o a d L o a d s a b i t m a p l e . S i m p l y n a v i g a t e t o t h e l e a s y o u w o u l d i n t h e l e b r o w s e r .

S a v e S a v e s t h e c u r r e n t l e . I f i t h a s n o t b e e n s a v e d b e f o r e , y o u w i l l b e g i v e n a c h a n c e

t o n a m e i t a n d c h o o s e t h e s a v i n g l o c a t i o n .

S e t W i d t h A l l o w s y o u t o c h a n g e t h e w i d t h o f t h e i m a g e . B o r d e r t o i n d i c a t e t h e w i d t h

w i l l b e s h o w n b u t i t d o e s n ' t a e c t d r a w i n g .

S e t H e i g h t A l l o w s y o u t o c h a n g e t h e h e i g h t o f t h e i m a g e . B o r d e r t o i n d i c a t e t h e h e i g h t

w i l l b e s h o w n b u t i t d o e s n ' t a e c t d r a w i n g .

B r u s h s p e e d C h a n g e s t h e s p e e d a t w h i c h t h e s e l e c t i o n c u r s o r m o v e s w h e n y o u h o l d d o w n

a m o v e m e n t b u t t o n .

B r u s h s i z e A l l o w s y o u t o a d j u s t t h e d r a w i n g s i z e o f t h e p e n c i l t o o l .

C h o o s e c o l o u r A l l o w s y o u t o m a n u a l l y e d i t t h e f o r e g r o u n d c o l o u r . Y o u c a n e d i t t h e

R B G a n d / o r t h e H S V v a l u e s .

G r i d s i z e A l l o w s y o u t o s h o w o r h i d e a g r i d o v e r t h e c a n v a s , a n d t o s p e c i f y i t s s i z e .

E x i t E x i t s R o c k p a i n t .

W a r n i n g : B E C A R E F U L . R o c k p a i n t w i l l N O T p r o m p t y o u t o s a v e i f y o u s e l e c t E x i t , !s o a n y u n s a v e d c h a n g e s w i l l b e l o s t .


P o w e r Q u i t s R o c k p a i n t i m m e d i a t e l y .


U p / D o w n

M o v e s t h e c u r s o r a r o u n d .

M e n u D i s p l a y s t h e M a i n M e n u .

A D i s p l a y s t h e t o o l b a r .

S e l e c t T o g g l e s t h e b r u s h a n d s e l e c t s o b j e c t s .




C h a p t e r 1 0 . P l u g i n s 1 6 4

1 0 . 4 . 1 6 . S t a t s

F i g u r e 1 0 . 5 4 . : T h e s t a t s - p l u g i n

T h e s t a t s p l u g i n c o u n t s t h e d i r e c t o r i e s a n d l e s ( t h e t o t a l n u m b e r a s w e l l a s t h e n u m b e r

o f a u d i o , p l a y l i s t , i m a g e a n d v i d e o l e s ) o n y o u r p l a y e r . P r e s s P o w e r t o a b o r t c o u n t i n g

a n d e x i t t h e p l u g i n . P r e s s i t a g a i n t o q u i t a f t e r c o u n t i n g h a s n i s h e d .




C h a p t e r 1 0 . P l u g i n s 1 6 5

1 0 . 4 . 1 7 . S t o p w a t c h

F i g u r e 1 0 . 5 5 . : S t o p w a t c h

A s i m p l e s t o p w a t c h p r o g r a m w i t h s u p p o r t f o r s a v i n g t i m e s .


P o w e r Q u i t P l u g i n

S e l e c t S t a r t / s t o p

A R e s e t t i m e r ( o n l y w h e n t i m e r i s s t o p p e d )

M e n u T a k e l a p t i m e

U p / D o w n S c r o l l t h r o u g h l a p t i m e s

1 0 . 4 . 1 8 . T e x t E d i t o r

T h i s p l u g i n a l l o w s y o u t o v i e w a n d e d i t s i m p l e t e x t d o c u m e n t s o n y o u r D A P . Y o u c a n

v i e w l e s b y u s i n g O p e n w i t h f r o m t h e C o n t e x t M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) .

U s a g e

I f y o u s t a r t t h e T e x t E d i t o r f r o m t h e p l u g i n b r o w s e r y o u w i l l b e g r e e t e d w i t h a b l a n k

s c r e e n . W h e n s t a r t e d f r o m t h e O p e n w i t h m e n u i t e m y o u r l e s h o u l d b e s h o w n o n t h e




C h a p t e r 1 0 . P l u g i n s 1 6 6

s c r e e n . Y o u c a n n o w e d i t t h e l e . T h e T e x t E d i t o r i s l i n e b a s e d . T h i s m e a n s y o u c a n

e d i t o n e l i n e a t a t i m e u s i n g t h e V i r t u a l K e y b o a r d ( s e e s e c t i o n 4 . 1 . 3 ( p a g e 2 6 ) ) .

• M o v e t h e s e l e c t i o n b a r t o t h e l i n e y o u w a n t t o e d i t .

• E d i t t h e h i g h l i g h t e d t e x t l i n e o r i n s e r t a n e w o n e u s i n g t h e I t e m M e n u .

• W h e n n i s h e d e d i t i n g e x i t t h e T e x t E d i t o r . Y o u ' l l b e s h o w n a l i s t o f s a v e o p t i o n s .

N o t e : W h e n y o u h a v e n o t c h a n g e d t h e l e t h e T e x t E d i t o r w i l l q u i t i m m e d i a t e l y . b


S e l e c t o r R i g h t F o r w a r d E d i t L i n e / S e l e c t C h a r a c t e r

L e f t o r P o w e r R e w i n d E x i t / A b o r t E d i t i n g

M e n u M e n u S h o w I t e m M e n u

L o n g S e l e c t L o n g M e n u D e l e t e L i n e




C h a p t e r 1 1 . A d v a n c e d T o p i c s 1 6 7

1 1 . A d v a n c e d T o p i c s

1 1 . 1 . C u s t o m i s i n g t h e U s e r I n t e r f a c e

1 1 . 1 . 1 . G e t t i n g E x t r a s

R o c k b o x s u p p o r t s c u s t o m f o n t s . A c o l l e c t i o n o f f o n t s i s a v a i l a b l e f o r d o w n l o a d i n t h e

f o n t p a c k a g e a t h t t p : / / w w w . r o c k b o x . o r g / d a i l y . s h t m l .

1 1 . 1 . 2 . L o a d i n g F o n t s

R o c k b o x c a n l o a d f o n t s d y n a m i c a l l y . S i m p l y c o p y t h e . f n t l e t o t h e p l a y e r a n d p l a y

i t i n t h e F i l e B r o w s e r . I f y o u w a n t a f o n t t o b e l o a d e d a u t o m a t i c a l l y e v e r y t i m e y o u

s t a r t u p , i t m u s t b e l o c a t e d i n t h e / . r o c k b o x / f o n t s d i r e c t o r y a n d t h e l e n a m e m u s t

b e a t m o s t 2 4 c h a r a c t e r s l o n g . Y o u c a n b r o w s e t h e f o n t s i n / . r o c k b o x / f o n t s u n d e r

S e t t i n g s → T h e m e S e t t i n g s → F o n t i n t h e M a i n M e n u .

N o t e : A d v a n c e d U s e r s O n l y : A n y B D F f o n t s h o u l d b e u s a b l e w i t h R o c k b o x . T o c o n v e r t bf r o m . b d f t o . f n t , u s e t h e c o n v b d f t o o l . T h i s t o o l c a n b e f o u n d i n t h e t o o l s d i r e c t o r y

o f t h e R o c k b o x s o u r c e c o d e . S e e ZC r e a t e F o n t s # C o n v B d f f o r m o r e d e t a i l s . O r j u s t r u n

c o n v b d f w i t h o u t a n y p a r a m e t e r s t o s e e t h e p o s s i b l e o p t i o n s .

1 1 . 1 . 3 . L o a d i n g L a n g u a g e s

R o c k b o x c a n l o a d l a n g u a g e l e s a t r u n t i m e . S i m p l y c o p y t h e . l n g l e ( d o n o t u s e t h e

. l a n g l e ) t o t h e p l a y e r a n d p l a y i t i n t h e R o c k b o x d i r e c t o r y b r o w s e r o r s e l e c t S e t t i n g s

→ G e n e r a l S e t t i n g s → L a n g u a g e f r o m t h e M a i n M e n u .

N o t e : I f y o u w a n t a l a n g u a g e t o b e l o a d e d a u t o m a t i c a l l y e v e r y t i m e y o u s t a r t u p , i t m u s t bb e l o c a t e d i n t h e

/ . r o c k b o x / l a n g s d i r e c t o r y a n d t h e l e n a m e m u s t b e a m a x i m u m o f

2 4 c h a r a c t e r s l o n g .

I f y o u r l a n g u a g e i s n o t y e t s u p p o r t e d a n d y o u w a n t t o w r i t e y o u r o w n l a n g u a g e l e

n d t h e i n s t r u c t i o n s o n t h e R o c k b o x w e b s i t e : Z L a n g F i l e s

1 1 . 1 . 4 . C h a n g i n g F i l e t y p e C o l o u r s

R o c k b o x h a s t h e c a p a b i l i t y t o m o d i f y t h e F i l e B r o w s e r t o s h o w l e s o f d i e r e n t t y p e s

i n d i e r e n t c o l o u r s , d e p e n d i n g o n t h e l e e x t e n s i o n .


http://www.rockbox.org/wiki/LangFiles

http://www.rockbox.org/wiki/CreateFonts#ConvBdf





S e t - u p

T h e r e a r e t w o s t e p s t o c h a n g i n g t h e l e t y p e c o l o u r s c r e a t i n g a l e w i t h t h e e x t e n s i o n

. c o l o u r s a n d t h e n a c t i v a t i n g i t u s i n g a c o n g l e . T h e . c o l o u r s l e s m u s t b e s t o r e d

i n t h e / . r o c k b o x / t h e m e s / d i r e c t o r y . T h e . c o l o u r s l e i s j u s t a t e x t l e , a n d c a n b e

e d i t e d w i t h y o u r t e x t e d i t o r o f c h o i c e .

C r e a t i n g t h e . c o l o u r s l e

T h e . c o l o u r s l e c o n s i s t s o f t h e l e e x t e n s i o n ( o r f o l d e r ) f o l l o w e d b y a c o l o n a n d t h e n

t h e c o l o u r d e s i r e d a s a n R G B v a l u e i n h e x a d e c i m a l , a s i n t h e f o l l o w i n g e x a m p l e :

f o l d e r : 8 0 8 0 8 0

m p 3 : 0 0 F F 0 0

o g g : 0 0 F F 0 0

t x t : F F 0 0 0 0

? ? ? : F F F F F F

T h e p e r m i s s i b l e e x t e n s i o n s a r e a s f o l l o w s :

f o l d e r , m 3 u , m 3 u 8 , c f g , w p s , l n g , r o c k , b m a r k , c u e , c o l o u r s , m p a , g i g a b e a t ,

m p 1 , m p 2 , m p 3 , o g g , o g a , w m a , w m v , a s f , w a v , f l a c , a c 3 , a 5 2 , m p c , w v , m 4 a ,

m 4 b , m p 4 , m o d , s h n , a i f , a i f f , s p x , s i d , a d x , n s f , n s f e , s p c , a p e , m a c , s a p ,

m p g , m p e g , b m p , f n t , k b d

A l l l e e x t e n s i o n s t h a t a r e n o t e i t h e r s p e c i c a l l y l i s t e d i n t h e . c o l o u r s l e s o r a r e n o t

i n t h e l i s t a b o v e w i l l b e s e t t o t h e c o l o u r g i v e n b y ? ? ? . E x t e n s i o n s t h a t a r e i n t h e a b o v e

l i s t b u t n o t i n t h e . c o l o u r s l e w i l l b e s e t t o t h e f o r e g r o u n d c o l o u r a s n o r m a l .

A c t i v a t i n g

T o a c t i v a t e t h e l e t y p e c o l o u r s , t h e . c o l o u r s l e n e e d s t o b e i n v o k e d f r o m a . c f g c o n -

g u r a t i o n l e . T h e e a s i e s t w a y t o d o t h i s i s t o c r e a t e a n e w t e x t l e c o n t a i n i n g t h e

f o l l o w i n g s i n g l e l i n e :

f i l e t y p e c o l o u r s : / . r o c k b o x / t h e m e s / f i l e n a m e . c o l o u r s

w h e r e l e n a m e i s r e p l a c e d b y t h e l e n a m e y o u u s e d w h e n c r e a t i n g t h e . c o l o u r s l e .

S a v e t h i s l e a s e . g . c o l o u r s . c f g i n t h e / . r o c k b o x / t h e m e s d i r e c t o r y a n d t h e n a c t i v a t e

t h e c o n g l e f r o m t h e m e n u a s n o r m a l ( S e t t i n g s → T h e m e S e t t i n g s → B r o w s e

T h e m e F i l e s ) .





E d i t i n g

T h e b u i l t - i n T e x t E d i t o r ( s e e s e c t i o n 1 0 . 4 . 1 8 ( p a g e 1 6 5 ) ) a u t o m a t i c a l l y u n d e r s t a n d s

t h e . c o l o u r s l e f o r m a t , b u t a n e x t e r n a l t e x t e d i t o r c a n a l s o b e u s e d . T o e d i t t h e

. c o l o u r s l e u s i n g R o c k b o x , p l a y i t i n t h e F i l e B r o w s e r . T h e l e w i l l o p e n i n t h e

T e x t E d i t o r . U p o n s e l e c t i n g a l i n e , t h e f o l l o w i n g c h o i c e s w i l l a p p e a r :

E x t e n s i o n

C o l o u r

I f E x t e n s i o n i s s e l e c t e d , t h e v i r t u a l k e y b o a r d ( s e e s e c t i o n 4 . 1 . 3 ( p a g e 2 6 ) ) a p p e a r s ,

a l l o w i n g t h e l e e x t e n s i o n t o b e m o d i e d . I f C o l o u r i s s e l e c t e d , t h e c o l o u r s e l e c t o r s c r e e n

a p p e a r s . C h o o s e t h e d e s i r e d c o l o u r , t h e n s a v e t h e . c o l o u r s l e u s i n g t h e s t a n d a r d T e x t

E d i t o r c o n t r o l s .

1 1 . 1 . 5 . L o a d i n g B a c k d r o p s

R o c k b o x s u p p o r t s s h o w i n g a n i m a g e a s a b a c k d r o p i n t h e F i l e B r o w s e r a n d t h e m e n u s .

T h e b a c k d r o p i m a g e m u s t b e a . b m p l e o f t h e e x a c t s a m e d i m e n s i o n s a s t h e d i s p l a y i n

y o u r p l a y e r ( 2 4 0 ×3 2 0 ×1 6 w i t h t h e l a s t n u m b e r g i v i n g t h e c o l o u r d e p t h i n b i t s ) . T o u s e

a n i m a g e a s a b a c k d r o p b r o w s e t o i t i n t h e F i l e B r o w s e r a n d o p e n t h e C o n t e x t

M e n u ( s e e s e c t i o n 4 . 1 . 2 ( p a g e 2 4 ) ) o n i t a n d s e l e c t t h e o p t i o n S e t A s B a c k d r o p . I f

y o u w a n t r o c k b o x t o r e m e m b e r y o u r b a c k d r o p t h e n e x t t i m e y o u s t a r t y o u r p l a y e r t h e

b a c k d r o p m u s t b e p l a c e d i n t h e / . r o c k b o x / b a c k d r o p s d i r e c t o r y .

1 1 . 1 . 6 . U I V i e w p o r t

B y d e f a u l t , t h e U I i s d r a w n o n t h e w h o l e s c r e e n . T h i s c a n b e c h a n g e d s o t h a t t h e U I i s

c o n n e d t o a s p e c i c a r e a o f t h e s c r e e n , b y u s e o f a U I v i e w p o r t . T h i s i s d o n e b y a d d i n g

t h e f o l l o w i n g l i n e t o t h e . c f g l e f o r a t h e m e :

u i v i e w p o r t : X , Y , [ w i d t h ] , [ h e i g h t ] , [ f o n t ] , [ f g c o l o u r ] , [ b g c o l o u r ]

O n l y t h e r s t t w o p a r a m e t e r s h a v e t o b e s p e c i e d , t h e o t h e r s c a n b e o m i t t e d u s i n g

` - ' a s a p l a c e h o l d e r . T h e s y n t a x i s v e r y s i m i l a r t o W P S v i e w p o r t s ( s e e s e c t i o n 1 1 . 2 . 2

( p a g e 1 7 1 ) ) . B r i e y :

• ` f g c o l o u r ' a n d ` b g c o l o u r ' a r e 6 - d i g i t R G B 8 8 8 c o l o u r s , e . g . F F 0 0 F F .

•` f o n t ' i s a n u m b e r : 0 i s t h e b u i l t - i n s y s t e m f o n t , 1 i s t h e u s e r - s e l e c t e d f o n t .

E x a m p l e

u i v i e w p o r t : 1 5 , 2 0 , 1 0 0 , 1 5 0 , - , - , -

T h i s d i s p l a y s t h e m e n u s t a r t i n g a t 1 5 p x f r o m t h e l e f t o f t h e s c r e e n a n d 2 0 p x f r o m t h e t o p

o f t h e s c r e e n . I t i s 1 0 0 p x w i d e a n d 1 5 0 p x h i g h . T h e f o n t a n d t h e f o r e g r o u n d / b a c k g r o u n d

c o l o u r s a r e d e n e d i n t h e t h e m e . c f g l e o r i n t h e T h e m e S e t t i n g s m e n u .





1 1 . 2 . C o n g u r i n g t h e T h e m e

1 1 . 2 . 1 . T h e m e i n g G e n e r a l I n f o

T h e r e a r e v a r i o u s d i e r e n t a s p e c t s o f t h e R o c k b o x i n t e r f a c e t h a t c a n b e t h e m e d t h e

W P S o r W h i l e P l a y i n g S c r e e n , t h e F M S o r F M S c r e e n ( i f t h e p l a y e r h a s a t u n e r ) ,

a n d t h e S B S o r B a s e S k i n . T h e W P S i s t h e n a m e u s e d t o d e s c r i b e t h e i n f o r m a t i o n

d i s p l a y e d o n t h e p l a y e r ' s s c r e e n w h i l s t a n a u d i o t r a c k i s b e i n g p l a y e d , t h e F M S i s t h e

s c r e e n s h o w n w h i l e l i s t e n i n g t o t h e r a d i o , a n d t h e S B S l e t s y o u s p e c i f y a b a s e s k i n t h a t i s

s h o w n i n t h e m e n u s a n d b r o w s e r s , a s w e l l a s t h e W P S a n d F M S . T h e S B S a l s o a l l o w s y o u

t o c o n t r o l c e r t a i n a s p e c t s o f t h e a p p e a r a n c e o f t h e m e n u s / b r o w s e r s . T h e r e a r e a n u m b e r

o f t h e m e s i n c l u d e d i n R o c k b o x , a n d y o u c a n l o a d o n e o f t h e s e a t a n y t i m e b y s e l e c t i n g

i t i n S e t t i n g s → T h e m e S e t t i n g s → B r o w s e T h e m e F i l e s . I t i s a l s o p o s s i b l e t o

s e t i n d i v i d u a l i t e m s o f a t h e m e f r o m w i t h i n t h e S e t t i n g s → T h e m e S e t t i n g s m e n u .

1 1 . 2 . 2 . T h e m e s C r e a t e Y o u r O w n

T h e t h e m e l e s a r e s i m p l e t e x t l e s , a n d c a n b e c r e a t e d ( o r e d i t e d ) i n y o u r f a v o u r i t e t e x t

e d i t o r . T o m a k e s u r e n o n - E n g l i s h c h a r a c t e r s d i s p l a y c o r r e c t l y i n y o u r t h e m e y o u m u s t

s a v e t h e t h e m e l e s w i t h U T F - 8 c h a r a c t e r e n c o d i n g . T h i s c a n b e d o n e i n m o s t e d i t o r s ,

f o r e x a m p l e N o t e p a d i n W i n d o w s 2 0 0 0 o r X P ( b u t n o t i n 9 x / M E ) c a n d o t h i s .

F i l e s L o c a t i o n s : E a c h d i e r e n t t h e m e a b l e a s p e c t r e q u i r e s i t s o w n l e W P S l e s

h a v e t h e e x t e n s i o n . w p s , F M s c r e e n l e s h a v e t h e e x t e n s i o n . f m s , a n d S B S l e s

h a v e t h e e x t e n s i o n . s b s . T h e m a i n t h e m e l e h a s t h e e x t e n s i o n . c f g . A l l l e s

s h o u l d h a v e t h e s a m e n a m e .

T h e t h e m e . c f g l e s h o u l d b e p l a c e d i n t h e / . r o c k b o x / t h e m e s d i r e c t o r y , w h i l e t h e

. w p s , . f m s a n d . s b s l e s s h o u l d b e p l a c e d i n t h e / . r o c k b o x / w p s d i r e c t o r y . A n y

i m a g e s u s e d b y t h e t h e m e s h o u l d b e p l a c e d i n a s u b d i r e c t o r y o f / . r o c k b o x / w p s

w i t h t h e s a m e n a m e a s t h e t h e m e , e . g . i f t h e t h e m e l e s a r e n a m e d m y t h e m e . w p s ,

m y t h e m e . s b s e t c . , t h e n t h e i m a g e s s h o u l d b e p l a c e d i n / . r o c k b o x / w p s / m y t h e m e .

A l l f u l l l i s t o f t h e a v a i l a b l e t a g s a r e g i v e n i n a p p e n d i x s e c t i o n B ( p a g e 1 8 5 ) ; s o m e o f

t h e m o r e p o w e r f u l c o n c e p t s i n t h e m e d e s i g n a r e d i s c u s s e d b e l o w .

• A l l c h a r a c t e r s n o t p r e c e d e d b y % a r e d i s p l a y e d a s t y p e d .

• L i n e s b e g i n n i n g w i t h # a r e c o m m e n t s a n d w i l l b e i g n o r e d .

N o t e : K e e p i n m i n d t h a t y o u r p l a y e r ' s r e s o l u t i o n i s 2 4 0 ×3 2 0 ×1 6 ( w i t h t h e l a s t n u m b e r bg i v i n g t h e c o l o u r d e p t h i n b i t s ) w h e n d e s i g n i n g y o u r o w n W P S , o r i f y o u u s e a W P S

d e s i g n e d f o r a n o t h e r t a r g e t .





V i e w p o r t s

B y d e f a u l t , a v i e w p o r t l l i n g t h e w h o l e s c r e e n c o n t a i n s a l l t h e e l e m e n t s d e n e d i n e a c h

t h e m e l e . T h e e l e m e n t s i n t h i s v i e w p o r t a r e d i s p l a y e d w i t h t h e s a m e b a c k g r o u n d /

f o r e g r o u n d c o l o u r s a n d t h e t e x t i s r e n d e r e d i n t h e s a m e f o n t a s i n t h e m a i n m e n u . T o

c h a n g e t h i s b e h a v i o u r a c u s t o m v i e w p o r t c a n b e d e n e d . A v i e w p o r t i s a r e c t a n g u l a r

w i n d o w o n t h e s c r e e n w i t h i t s o w n f o r e g r o u n d / b a c k g r o u n d c o l o u r s . T h i s w i n d o w a l s o

h a s v a r i a b l e d i m e n s i o n s . T o d e n e a v i e w p o r t a l i n e s t a r t i n g % V ( . . . h a s t o b e p r e s e n t i n

t h e t h e m e l e . T h e f u l l s y n t a x w i l l b e e x p l a i n e d l a t e r i n t h i s s e c t i o n . A l l e l e m e n t s p l a c e d

b e f o r e t h e l i n e d e n i n g a v i e w p o r t a r e d i s p l a y e d i n t h e d e f a u l t v i e w p o r t . E l e m e n t s

d e n e d a f t e r a v i e w p o r t d e c l a r a t i o n a r e d r a w n w i t h i n t h a t v i e w p o r t . L o a d i n g i m a g e s

( s e e A p p e n d i x s e c t i o n B . 2 0 ( p a g e 1 9 2 ) ) s h o u l d b e d o n e w i t h i n t h e d e f a u l t v i e w p o r t . A

v i e w p o r t e n d s e i t h e r w i t h t h e e n d o f t h e l e , o r w i t h t h e n e x t v i e w p o r t d e c l a r a t i o n l i n e .

V i e w p o r t s s h a r i n g t h e s a m e c o o r d i n a t e s a n d d i m e n s i o n s c a n n o t b e d i s p l a y e d a t t h e s a m e

t i m e . V i e w p o r t s c a n n o t b e l a y e r e d t r a n s p a r e n t l y o v e r o n e a n o t h e r . S u b s e q u e n t v i e w p o r t s

w i l l b e d r a w n o v e r a n y o t h e r v i e w p o r t s a l r e a d y d r a w n o n t o t h a t a r e a o f t h e s c r e e n .

V i e w p o r t D e c l a r a t i o n S y n t a x

% V ( x , y , [ w i d t h ] , [ h e i g h t ] , [ f o n t ] ) % V f ( [ f g c o l o u r ] ) % V b ( [ b g c o l o u r ] )

• ` f g c o l o u r ' a n d ` b g c o l o u r ' a r e 6 - d i g i t R G B 8 8 8 c o l o u r s , e . g . F F 0 0 F F .

• ` f o n t ' i s a n u m b e r : 0 i s t h e b u i l t - i n s y s t e m f o n t , 1 i s t h e c u r r e n t m e n u f o n t , a n d

2 - 9 a r e a d d i t i o n a l s k i n l o a d e d f o n t s ( s e e s e c t i o n 1 1 . 2 . 4 ( p a g e 1 7 3 ) ) .

• O n l y t h e c o o r d i n a t e s h a v e t o b e s p e c i e d . L e a v i n g t h e o t h e r d e n i t i o n s b l a n k w i l l

s e t t h e m t o t h e i r d e f a u l t v a l u e s .

N o t e : T h e c o r r e c t n u m b e r o f c o m m a s w i t h h y p h e n s i n b l a n k e l d s a r e s t i l l n e e d e d i n ba n y c a s e .

E x a m p l e

% V ( 1 2 , 2 0 , - , - , 1 ) % V f ( 0 0 0 0 0 0 ) % V b ( F F F F F F )

% s T h i s v i e w p o r t i s d i s p l a y e d p e r m a n e n t l y . I t s t a r t s 1 2 p x f r o m t h e l e f t a n d

% s 2 0 p x f r o m t h e t o p o f t h e s c r e e n , a n d f i l l s t h e r e s t o f t h e s c r e e n f r o m

% s t h a t p o i n t . T h e l i n e s w i l l s c r o l l i f t h i s t e x t d o e s n o t f i t i n t h e v i e w p o r t .

% s T h e u s e r f o n t i s u s e d , a n d t h e f o r e g r o u n d a n d b a c k g r o u n d a r e s e t t o b l a c k

% s a n d w h i t e r e s p e c t i v e l y .

V i e w p o r t d e n i t i o n D e f a u l t v a l u e

w i d t h / h e i g h t r e m a i n i n g p a r t o f s c r e e n

f o n t u s e r d e n e d

f o r e g r o u n d / b a c k g r o u n d

c o l o u r s

d e n e d b y t h e m e





C o n d i t i o n a l V i e w p o r t s

A n y v i e w p o r t c a n b e d i s p l a y e d e i t h e r p e r m a n e n t l y o r c o n d i t i o n a l l y . D e n i n g a v i e w p o r t

a s % V ( . . . w i l l d i s p l a y i t p e r m a n e n t l y .

• % V l ( ' i d e n t i f i e r ' , . . . ) T h i s t a g p r e l o a d s a v i e w p o r t f o r l a t e r d i s p l a y . ` i d e n t i e r '

i s a s i n g l e l o w e r c a s e l e t t e r ( a - z ) a n d t h e ` . . . ' p a r a m e t e r s u s e t h e s a m e l o g i c a s t h e

% V t a g e x p l a i n e d a b o v e .

• % V d ( ' i d e n t i f i e r ' ) D i s p l a y t h e ` i d e n t i e r ' v i e w p o r t .

V i e w p o r t s c a n s h a r e i d e n t i e r s s o t h a t y o u c a n d i s p l a y m u l t i p l e v i e w p o r t s w i t h o n e

% V d l i n e .

E x a m p l e

% ? C < % V d ( a ) | % V d ( b ) >

% V l ( a , 1 0 , 1 0 , 5 0 , 5 0 , - )

% C l ( 0 , 0 , 5 0 , 5 0 , c , c )

% C d

% V l ( a , 0 , 7 0 , 7 0 , 1 4 , 1 )

% s % a c T h e r e y o u h a v e i t : A l b u m a r t .

% V l ( b , 2 0 , 1 4 , 5 0 , 1 4 , 1 ) % V f ( f f 0 0 0 0 ) % V b ( f f f f f f )

% t ( 1 ) % a c W a r n i n g : ; % t ( . 1 )

% V l ( b , 2 0 , 3 0 , 5 0 , 5 0 , 1 ) % V f ( 0 0 0 0 0 0 ) % V b ( f f f f f f )

% s N o a l b u m a r t f o u n d

% s c h e c k y o u r f i l e n a m e s .

T h i s e x a m p l e c h e c k s f o r a l b u m a r t . A l b u m a r t w i l l b e d i s p l a y e d i n v i e w p o r t ` a ' , i f i t i s

f o u n d . O t h e r w i s e a r e d a s h i n g w a r n i n g w i l l b e d i s p l a y e d i n v i e w p o r t ` b ' .

N o t e : T h e t a g t o d i s p l a y c o n d i t i o n a l v i e w p o r t s m u s t c o m e b e f o r e t h e t a g t o p r e l o a d t h e bv i e w p o r t i n t h e . w p s l e .

1 1 . 2 . 3 . I n f o V i e w p o r t ( S B S o n l y )

A s m e n t i o n e d a b o v e , i t i s p o s s i b l e t o s e t a U I v i e w p o r t v i a t h e t h e m e . c f g l e . I t i s a l s o

p o s s i b l e t o s e t t h e U I v i e w p o r t t h r o u g h t h e S B S l e , a n d t o c o n d i t i o n a l l y s e l e c t d i e r e n t

U I v i e w p o r t s .

• % V i ( ' l a b e l ' , . . . ) T h i s v i e w p o r t i s u s e d a s C u s t o m U I V i e w p o r t i n t h e c a s e t h a t

t h e t h e m e d o e s n ' t h a v e a u i v i e w p o r t s e t i n t h e t h e m e . c f g l e . H a v i n g t h i s i s

s t r o n g l y r e c o m m e n d e d s i n c e i t m a k e s y o u a b l e t o u s e t h e S B S w i t h o t h e r t h e m e s .

I f l a b e l i s s e t t h i s v i e w p o r t c a n b e s e l e c t i v l y u s e d a s t h e I n f o V i e w p o r t u s i n g t h e

% V I t a g . T h e ` . . . ' p a r a m e t e r s u s e t h e s a m e l o g i c a s t h e % V t a g e x p l a i n e d a b o v e .

• % V I ( ' l a b e l ' ) S e t t h e I n f o V i e w p o r t t o u s e t h e v i e w p o r t c a l l e d l a b e l , a s d e c l a r e d

w i t h t h e p r e v i o u s t a g .





1 1 . 2 . 4 . A d d i t i o n a l F o n t s

A d d i t i o n a l f o n t s c a n b e l o a d e d w i t h i n e a c h s c r e e n l e t o b e u s e d i n t h a t s c r e e n . I n t h i s

w a y n o t o n l y c a n y o u h a v e d i e r e n t f o n t s b e t w e e n e . g . t h e m e n u a n d t h e W P S , b u t y o u

c a n u s e m u l t i p l e f o n t s i n e a c h o f t h e i n d i v i d u a l s c r e e n s .

% F l ( ' i d ' , f i l e n a m e , g l y p h s )

• ` i d ' i s t h e n u m b e r y o u w a n t t o u s e i n v i e w p o r t d e c l a r a t i o n s , 0 a n d 1 a r e r e s e r v e d

a n d s o c a n ' t b e u s e d .

• ` l e n a m e ' i s t h e f o n t l e n a m e t o l o a d . F o n t s s h o u l d b e s t o r e d i n / . r o c k b o x / f o n t s /

• ` g l y p h s ' i s a n o p t i o n a l s p e c i c a t i o n o f h o w m a n y u n i q u e g l y p h s t o s t o r e i n m e m o r y .

D e f a u l t i s 2 5 6 .

A n e x a m p l e w o u l d b e : % F l ( 2 , 1 2 - N i m b u s . f n t , 1 0 0 )

C o n d i t i o n a l T a g s

I f / e l s e : S y n t a x : % ? x x < t r u e | f a l s e >

I f t h e t a g s p e c i e d b y x x h a s a v a l u e , t h e t e x t b e t w e e n t h e < a n d t h e | i s

d i s p l a y e d ( t h e t r u e p a r t ) , e l s e t h e t e x t b e t w e e n t h e | a n d t h e > i s d i s p l a y e d

( t h e f a l s e p a r t ) . T h e e l s e p a r t i s o p t i o n a l , s o t h e | d o e s n o t h a v e t o b e s p e c i e d

i f n o e l s e p a r t i s d e s i r e d . T h e c o n d i t i o n a l s n e s t , s o t h e t e x t i n t h e i f a n d e l s e p a r t

c a n c o n t a i n a l l % c o m m a n d s , i n c l u d i n g c o n d i t i o n a l s .

E n u m e r a t i o n s : S y n t a x : % ? x x < a l t 1 | a l t 2 | a l t 3 | . . . | e l s e >

F o r t a g s w i t h m u l t i p l e v a l u e s , l i k e P l a y s t a t u s , t h e c o n d i t i o n a l c a n h o l d a l i s t o f

a l t e r n a t i v e s , o n e f o r e a c h v a l u e t h e t a g c a n h a v e . E x a m p l e e n u m e r a t i o n :

E x a m p l e

% ? m p < S t o p | % P l a y | P a u s e | F f w d | R e w >

T h e l a s t e l s e p a r t i s o p t i o n a l , a n d w i l l b e d i s p l a y e d i f t h e t a g h a s n o v a l u e . T h e

W P S p a r s e r w i l l a l w a y s d i s p l a y t h e l a s t p a r t i f t h e t a g h a s n o v a l u e , o r i f t h e l i s t

o f a l t e r n a t i v e s i s t o o s h o r t .

N e x t S o n g I n f o

Y o u c a n d i s p l a y i n f o r m a t i o n a b o u t t h e n e x t s o n g t h e s o n g t h a t i s a b o u t t o p l a y a f t e r

t h e o n e c u r r e n t l y p l a y i n g ( u n l e s s y o u c h a n g e t h e p l a n ) .

I f y o u u s e t h e u p p e r - c a s e v e r s i o n s o f t h e t h r e e t a g s : F , I a n d D , t h e y w i l l i n s t e a d r e f e r

t o t h e n e x t s o n g i n s t e a d o f t h e c u r r e n t o n e . E x a m p l e : % I g i s t h e g e n r e n a m e u s e d i n t h e

n e x t s o n g a n d % F f i s t h e m p 3 f r e q u e n c y .

N o t e : T h e n e x t s o n g i n f o r m a t i o n w i l l n o t b e a v a i l a b l e a t a l l t i m e s , b u t w i l l m o s t l i k e l y b





b e a v a i l a b l e a t t h e e n d o f a s o n g . W e s u g g e s t y o u u s e t h e c o n d i t i o n a l d i s p l a y t a g a l o t

w h e n d i s p l a y i n g i n f o r m a t i o n a b o u t t h e n e x t s o n g !

A l t e r n a t i n g S u b l i n e s

I t i s p o s s i b l e t o g r o u p i t e m s o n e a c h l i n e i n t o 2 o r m o r e g r o u p s o r s u b l i n e s . E a c h s u b l i n e

w i l l b e d i s p l a y e d i n s u c c e s s i o n o n t h e l i n e f o r a s p e c i e d t i m e , a l t e r n a t i n g c o n t i n u o u s l y

t h r o u g h e a c h d e n e d s u b l i n e .

I t e m s o n a l i n e a r e b r o k e n i n t o s u b l i n e s w i t h t h e s e m i c o l o n ` ; ' c h a r a c t e r . T h e d i s p l a y

t i m e f o r e a c h s u b l i n e d e f a u l t s t o 2 s e c o n d s u n l e s s m o d i e d b y u s i n g t h e ` % t ' t a g t o

s p e c i f y a n a l t e r n a t e t i m e ( i n s e c o n d s a n d o p t i o n a l t e n t h s o f a s e c o n d ) f o r t h e s u b l i n e t o

b e d i s p l a y e d .

S u b l i n e r e l a t e d s p e c i a l c h a r a c t e r s a n d t a g s :

; S p l i t i t e m s o n a l i n e i n t o s e p a r a t e s u b l i n e s

% t S e t t h e s u b l i n e d i s p l a y t i m e . T h e ` % t ' i s f o l l o w e d b y e i t h e r i n t e g e r s e c o n d s ( % t 5 ) , o r

s e c o n d s a n d t e n t h s o f a s e c o n d w i t h i n ( ) e . g . ( % t ( 3 . 5 ) ) .

E a c h a l t e r n a t i n g s u b l i n e c a n s t i l l b e o p t i o n a l l y s c r o l l e d w h i l e i t i s b e i n g d i s p l a y e d , a n d

s c r o l l a b l e f o r m a t s c a n b e d i s p l a y e d o n t h e s a m e l i n e w i t h n o n - s c r o l l a b l e f o r m a t s ( s u c h a s

t r a c k e l a p s e d t i m e ) a s l o n g a s t h e y a r e s e p a r a t e d i n t o d i e r e n t s u b l i n e s . E x a m p l e s u b l i n e

d e n i t i o n :

E x a m p l e

% s % t ( 4 ) % i a ; % s % i t ; % t ( 3 ) % p c % p r : D i s p l a y i d 3 a r t i s t f o r 4 s e c o n d s ,

D i s p l a y i d 3 t i t l e f o r 2 s e c o n d s ,

D i s p l a y c u r r e n t a n d r e m a i n i n g t r a c k t i m e

f o r 3 s e c o n d s ,

r e p e a t . . .

C o n d i t i o n a l s c a n b e u s e d w i t h s u b l i n e s t o d i s p l a y a d i e r e n t s e t a n d / o r n u m b e r o f

s u b l i n e s o n t h e l i n e d e p e n d i n g o n t h e e v a l u a t i o n o f t h e c o n d i t i o n a l . E x a m p l e s u b l i n e

w i t h c o n d i t i o n a l s :

E x a m p l e

% ? i t < % t ( 8 ) % s % i t | % s % f n > ; % ? i a < % t ( 3 ) % s % i a | % t ( 0 ) >

T h e f o r m a t a b o v e w i l l d o t w o d i e r e n t t h i n g s d e p e n d i n g i f I D 3 t a g s a r e p r e s e n t . I f t h e

I D 3 a r t i s t a n d t i t l e a r e p r e s e n t :

• D i s p l a y i d 3 t i t l e f o r 8 s e c o n d s ,

•D i s p l a y i d 3 a r t i s t f o r 3 s e c o n d s ,

• r e p e a t . . .

I f t h e I D 3 a r t i s t a n d t i t l e a r e n o t p r e s e n t :

• D i s p l a y t h e l e n a m e c o n t i n u o u s l y .

N o t e t h a t b y u s i n g a s u b l i n e d i s p l a y t i m e o f 0 i n o n e b r a n c h o f a c o n d i t i o n a l , a s u b l i n e

c a n b e s k i p p e d ( n o t d i s p l a y e d ) w h e n t h a t c o n d i t i o n i s m e t .





U s i n g I m a g e s

Y o u c a n h a v e a s m a n y a s 5 2 i m a g e s i n y o u r W P S . T h e r e a r e v a r i o u s w a y s o f d i s p l a y i n g

i m a g e s :

1 . L o a d a n d a l w a y s s h o w t h e i m a g e , u s i n g t h e % x t a g

2 . P r e l o a d t h e i m a g e w i t h % x l a n d s h o w i t w i t h % x d . T h i s w a y y o u c a n h a v e y o u r

i m a g e s d i s p l a y e d c o n d i t i o n a l l y .

3 . L o a d a n i m a g e a n d s h o w a s b a c k d r o p u s i n g t h e % X t a g . T h e i m a g e m u s t b e o f t h e

s a m e e x a c t d i m e n s i o n s a s y o u r d i s p l a y .

E x a m p l e o n b a c k g r o u n d i m a g e u s e :

E x a m p l e

% X ( b a c k g r o u n d . b m p )

T h e i m a g e w i t h l e n a m e b a c k g r o u n d . b m p i s l o a d e d a n d u s e d i n t h e W P S .

E x a m p l e o n b i t m a p p r e l o a d i n g a n d u s e :

E x a m p l e

% x ( a , s t a t i c _ i c o n . b m p , 5 0 , 5 0 )

% x l ( b , r e p _ o f f . b m p , 1 6 , 6 4 )

% x l ( c , r e p _ a l l . b m p , 1 6 , 6 4 )

% x l ( d , r e p _ o n e . b m p , 1 6 , 6 4 )

% x l ( e , r e p _ s h u f f l e . b m p , 1 6 , 6 4 )

% ? m m < % x d ( b ) | % x d ( c ) | % x d ( d ) | % x d ( e ) >

F o u r i m a g e s a t t h e s a m e x a n d y p o s i t i o n a r e p r e l o a d e d i n t h e e x a m p l e . W h i c h i m a g e

t o d i s p l a y i s d e t e r m i n e d b y t h e % m m t a g ( t h e r e p e a t m o d e ) .

E x a m p l e F i l e

E x a m p l e

% s % ? i n < % i n - > % ? i t < % i t | % f n > % ? i a < [ % i a % ? i d < , % i d > ] >

% p b % p c / % p t

T h a t i s , t r a c k n u m t i t l e [ a r t i s t , a l b u m ] , w h e r e m o s t e l d s a r e o n l y d i s p l a y e d i f a v a i l a b l e .

C o u l d a l s o b e r e n d e r e d a s l e n a m e o r t r a c k n u m t i t l e [ a r t i s t ] .

1 1 . 3 . M a n a g i n g R o c k b o x S e t t i n g s

1 1 . 3 . 1 . I n t r o d u c t i o n t o . c f g F i l e s

R o c k b o x a l l o w s u s e r s t o s t o r e a n d l o a d m u l t i p l e s e t t i n g s t h r o u g h t h e u s e o f c o n g u r a t i o n

l e s . A c o n g u r a t i o n l e i s s i m p l y a t e x t l e w i t h t h e e x t e n s i o n . c f g .

A c o n g u r a t i o n l e m a y r e s i d e a n y w h e r e o n t h e d i s k . M u l t i p l e c o n g u r a t i o n l e s a r e

p e r m i t t e d . S o , f o r e x a m p l e , y o u c o u l d h a v e a c a r . c f g l e f o r t h e s e t t i n g s t h a t y o u u s e





w h i l e p l a y i n g y o u r j u k e b o x i n y o u r c a r , a n d a h e a d p h o n e s . c f g l e t o s t o r e t h e s e t t i n g s

t h a t y o u u s e w h i l e l i s t e n i n g t o y o u r p l a y e r t h r o u g h h e a d p h o n e s .

S e e s e c t i o n 1 1 . 3 . 2 ( p a g e 1 7 6 ) b e l o w f o r a n e x p l a n a t i o n o f t h e f o r m a t f o r c o n g u r a t i o n

l e s . S e e s e c t i o n 1 1 . 3 . 3 ( p a g e 1 7 7 ) f o r a n e x p l a n a t i o n o f h o w t o c r e a t e , e d i t a n d l o a d

c o n g u r a t i o n l e s .

1 1 . 3 . 2 . S p e c i c a t i o n s f o r . c f g F i l e s

T h e R o c k b o x c o n g u r a t i o n l e i s a p l a i n t e x t l e , s o o n c e y o u u s e t h e S a v e . c f g f i l e

o p t i o n t o c r e a t e t h e l e , y o u c a n e d i t t h e l e o n y o u r c o m p u t e r u s i n g a n y t e x t e d i t o r

p r o g r a m . S e e A p p e n d i x s e c t i o n C ( p a g e 1 9 9 ) f o r a v a i l a b l e s e t t i n g s . C o n g u r a t i o n l e s

u s e t h e f o l l o w i n g f o r m a t t i n g r u l e s :

1 . E a c h s e t t i n g m u s t b e o n a s e p a r a t e l i n e .

2 . E a c h l i n e h a s t h e f o r m a t s e t t i n g : v a l u e .

3 . V a l u e s m u s t b e w i t h i n t h e r a n g e s s p e c i e d i n t h i s m a n u a l f o r e a c h s e t t i n g .

4 . L i n e s s t a r t i n g w i t h # a r e i g n o r e d . T h i s l e t s y o u w r i t e c o m m e n t s i n t o y o u r c o n g -

u r a t i o n l e s .

E x a m p l e o f a c o n g u r a t i o n l e :

E x a m p l e

v o l u m e : 7 0

b a s s : 1 1

t r e b l e : 1 2

b a l a n c e : 0

t i m e f o r m a t : 1 2 h o u r

v o l u m e d i s p l a y : n u m e r i c

s h o w f i l e s : s u p p o r t e d

w p s : / . r o c k b o x / c a r . w p s

l a n g : / . r o c k b o x / a f r i k a a n s . l n g

N o t e : A s y o u c a n s e e f r o m t h e e x a m p l e , c o n g u r a t i o n l e s d o n o t n e e d t o c o n t a i n a l l bo f t h e R o c k b o x o p t i o n s . Y o u c a n c r e a t e c o n g u r a t i o n l e s t h a t c h a n g e o n l y c e r t a i n s e t -

t i n g s . S o , f o r e x a m p l e , s u p p p o s e y o u t y p i c a l l y u s e t h e p l a y e r a t o n e v o l u m e i n t h e c a r ,

a n d a n o t h e r w h e n u s i n g h e a d p h o n e s . F u r t h e r , s u p p o s e y o u l i k e t o u s e a n i n v e r s e L C D

w h e n y o u a r e i n t h e c a r , a n d a r e g u l a r L C D s e t t i n g w h e n y o u a r e u s i n g h e a d p h o n e s . Y o u

c o u l d c r e a t e c o n g u r a t i o n l e s t h a t c o n t r o l o n l y t h e v o l u m e a n d L C D s e t t i n g s . C r e a t e a

f e w d i e r e n t l e s w i t h d i e r e n t s e t t i n g s , g i v e e a c h l e a d i e r e n t n a m e ( s u c h a s c a r . c f g ,

h e a d p h o n e s . c f g , e t c . ) , a n d y o u c a n t h e n u s e t h e B r o w s e . c f g f i l e s o p t i o n t o q u i c k l y

c h a n g e s e t t i n g s .

A s p e c i a l c a s e c o n g u r a t i o n l e c a n b e u s e d t o f o r c e a p a r t i c u l a r s e t t i n g o r s e t t i n g s

e v e r y t i m e R o c k b o x s t a r t s u p ( e . g . t o s e t t h e v o l u m e t o a s a f e l e v e l ) . F o r m a t a n e w

c o n g u r a t i o n l e a s a b o v e w i t h t h e r e q u i r e d s e t t i n g ( s ) a n d s a v e i t i n t o t h e / . r o c k b o x

d i r e c t o r y w i t h t h e l e n a m e f i x e d . c f g .





1 1 . 3 . 3 . T h e M a n a g e S e t t i n g s m e n u

T h e M a n a g e S e t t i n g s m e n u c a n b e f o u n d i n t h e M a i n M e n u . T h e M a n a g e S e t -

t i n g s m e n u a l l o w s y o u t o s a v e a n d l o a d . c f g l e s .

B r o w s e . c f g F i l e s O p e n s t h e F i l e B r o w s e r i n t h e / . r o c k b o x d i r e c t o r y a n d d i s p l a y s

a l l . c f g ( c o n g u r a t i o n ) l e s . S e l e c t i n g a . c f g l e w i l l c a u s e R o c k b o x t o l o a d

t h e s e t t i n g s c o n t a i n e d i n t h a t l e . P r e s s i n g L e f t o r P o w e r w i l l e x i t b a c k t o t h e

M a n a g e S e t t i n g s m e n u . S e e t h e W r i t e . c f g f i l e s o p t i o n o n t h e M a n a g e

S e t t i n g s m e n u f o r d e t a i l s o f h o w t o s a v e a n d e d i t a c o n g u r a t i o n l e .

R e s e t S e t t i n g s T h i s w i p e s t h e s a v e d s e t t i n g s i n t h e p l a y e r a n d r e s e t s a l l s e t t i n g s t o t h e i r

d e f a u l t v a l u e s .

N o t e : Y o u c a n a l s o r e s e t a l l s e t t i n g s t o t h e i r d e f a u l t v a l u e s b y t u r n i n g o t h e bp l a y e r , t u r n i n g i t b a c k o n a n d p r e s s i n g t h e A b u t t o n i m m e d i a t e l y a f t e r t h e p l a y e r

t u r n s o n .

S a v e . c f g F i l e T h i s o p t i o n w r i t e s a . c f g l e t o y o u r p l a y e r ' s d i s k . T h e c o n g u r a t i o n

l e h a s t h e . c f g e x t e n s i o n a n d i s u s e d t o s t o r e a l l o f t h e u s e r s e t t i n g s t h a t a r e

d e s c r i b e d t h r o u g h o u t t h i s m a n u a l .

H i n t : U s e t h e S a v e . c f g F i l e f e a t u r e ( M a i n M e n u → M a n a g e S e t t i n g s ) t o

s a v e t h e c u r r e n t s e t t i n g s , t h e n u s e a t e x t e d i t o r t o c u s t o m i z e t h e s e t t i n g s l e . S e e

A p p e n d i x s e c t i o n C ( p a g e 1 9 9 ) f o r t h e f u l l r e f e r e n c e o f a v a i l a b l e o p t i o n s .

S a v e S o u n d S e t t i n g s T h i s o p t i o n w r i t e s a . c f g l e t o y o u r p l a y e r ' s d i s k . T h e c o n g -

u r a t i o n l e h a s t h e . c f g e x t e n s i o n a n d i s u s e d t o s t o r e a l l o f t h e s o u n d r e l a t e d

s e t t i n g s .

S a v e T h e m e S e t t i n g s T h i s o p t i o n w r i t e s a . c f g l e t o y o u r p l a y e r ' s d i s k . T h e c o n g -

u r a t i o n l e h a s t h e . c f g e x t e n s i o n a n d i s u s e d t o s t o r e a l l o f t h e t h e m e r e l a t e d

s e t t i n g s .

1 1 . 4 . F i r m w a r e L o a d i n g

1 1 . 4 . 1 . U s i n g R O L O ( R o c k b o x L o a d e r )

R o c k b o x i s a b l e t o l o a d a n d s t a r t a n o t h e r r m w a r e l e w i t h o u t r e b o o t i n g . Y o u j u s t

p l a y a l e w i t h t h e e x t e n s i o n . g i g a b e a t . T h i s c a n b e u s e d t o t e s t n e w r m w a r e

v e r s i o n s w i t h o u t d e l e t i n g y o u r c u r r e n t v e r s i o n .

1 1 . 5 . O p t i m i s i n g b a t t e r y r u n t i m e

R o c k b o x o e r s a l o t o f s e t t i n g s t h a t h a v e h i g h i m p a c t o n t h e b a t t e r y r u n t i m e o f y o u r

p l a y e r . T h e l a r g e s t p o w e r s a v i n g s c a n b e a c h i e v e d t h r o u g h d i s a b l i n g u n n e e d e d h a r d w a r e





c o m p o n e n t s f o r s o m e o f t h o s e t h e r e a r e s e t t i n g s a v a i l a b l e . A n o t h e r a r e a o f s a v i n g s i s

a v o i d i n g o r r e d u c i n g C P U b o o s t i n g t h r o u g h d i s a b l i n g c o m p u t i n g i n t e n s e f e a t u r e s ( e . g .

s o u n d p r o c e s s i n g ) o r u s i n g e e c t i v e a u d i o c o d e c s . T h e f o l l o w i n g p r o v i d e s a s h o r t

o v e r v i e w o f t h e m o s t r e l e v a n t s e t t i n g s a n d r u l e s o f t h u m b .

1 1 . 5 . 1 . D i s p l a y b a c k l i g h t

T h e a c t i v e b a c k l i g h t c o n s u m e s a l o t o f p o w e r . T h e r e f o r e c h o o s e a s e t t i n g t h a t d i s a b l e s

t h e b a c k l i g h t a f t e r t i m e o u t ( f o r s e t t i n g B a c k l i g h t s e e s e c t i o n 8 . 4 ( p a g e 6 3 ) ) . A v o i d t o

h a v e t h e b a c k l i g h t e n a b l e d a l l t h e t i m e .

1 1 . 5 . 2 . D i s p l a y p o w e r - o

S h u t t i n g d o w n t h e d i s p l a y a n d t h e d i s p l a y c o n t r o l l e r s a v e s a r e a s o n a b l e a m o u n t o f p o w e r .

C h o o s e a s e t t i n g t h a t w i l l p u t t h e d i s p l a y t o s l e e p a f t e r t i m e o u t ( f o r s e t t i n g S l e e p s e e

s e c t i o n 8 . 4 ( p a g e 6 3 ) ) . A v o i d t o h a v e t h e d i s p l a y e n a b l e d a l l t h e t i m e e v e n , i f t h e d i s p l a y

i s t r a n s e c t i v e a n d i s r e a d a b l e w i t h o u t b a c k l i g h t . D e p e n d i n g o n y o u r p l a y e r i t m i g h t b e

s i g n i c a n t l y m o r e e c i e n t t o r e - e n a b l e t h e d i s p l a y a n d i t s b a c k l i g h t f o r a g l i m p s e a f e w

t i m e s p e r h o u r t h a n t o k e e p t h e d i s p l a y e n a b l e d .

1 1 . 5 . 3 . A n t i - S k i p B u e r

H a v i n g a l a r g e a n t i - s k i p b u e r t e n d s t o u s e m o r e p o w e r , a n d m a y r e d u c e y o u r b a t t e r y

l i f e . I t i s r e c o m m e n d e d t o a l w a y s u s e t h e l o w e s t p o s s i b l e s e t t i n g t h a t a l l o w s c o r r e c t a n d

c o n t i n u o u s p l a y b a c k ( s e e s e c t i o n 7 . 5 ( p a g e 5 5 ) ) .

1 1 . 5 . 4 . R e p l a y g a i n

R e p l a y g a i n i s a p o s t p r o c e s s i n g t h a t e q u a l i s e s t h e p l a y b a c k v o l u m e o f a u d i o l e s t o t h e

s a m e p e r c e i v e d l o u d n e s s . T h i s p o s t p r o c e s s i n g a p p l i e s a f a c t o r t o e a c h s i n g l e P C M s a m p l e

a n d i s t h e r e f o r e c o n s u m i n g a d d i t i o n a l C P U t i m e . I f y o u w a n t t o a c h i e v e s o m e ( m i n o r )

s a v i n g s i n r u n t i m e , s w i t c h t h i s f e a t u r e o ( s e e s e c t i o n 7 . 9 ( p a g e 5 7 ) ) .

1 1 . 5 . 5 . A u d i o f o r m a t a n d b i t r a t e

I n g e n e r a l t h e f a s t e s t d e c o d i n g a u d i o f o r m a t w i l l b e t h e b e s t i n t e r m s o f b a t t e r y r u n t i m e

o n y o u r p l a y e r . A n o v e r v i e w o f d i e r e n t c o d e c ' s p e r f o r m a n c e o n d i e r e n t p l a y e r s c a n b e

f o u n d a t ZC o d e c P e r f o r m a n c e C o m p a r i s o n .

Y o u r t a r g e t u s e s a h a r d d i s k w h i c h c o n s u m e s a l a r g e a m o u n t o f p o w e r w h i l e s p i n n i n g

u p t o s e v e r a l h u n d r e d m A . T h e l e s s o f t e n t h e h a r d d i s k n e e d s t o s p i n u p f o r b u e r i n g

a n d t h e s h o r t e r t h e b u e r i n g d u r a t i o n i s , t h e l o w e r i s t h e p o w e r c o n s u m p t i o n . T h e r e f o r e

t h e b i t r a t e o f t h e a u d i o l e s d o e s h a v e a n i m p a c t o n t h e b a t t e r y r u n t i m e a s w e l l . L o w e r

b i t r a t e a u d i o l e s w i l l r e s u l t i n l o n g e r b a t t e r y r u n t i m e .


http://www.rockbox.org/wiki/CodecPerformanceComparison




P l e a s e d o n o t r e - e n c o d e a n y e x i s t i n g a u d i o l e s f r o m o n e l o s s y f o r m a t t o a n o t h e r b a s e d

u p o n t h e a b o v e m e n t i o n e d . T h i s w i l l r e d u c e t h e a u d i o q u a l i t y . I f y o u h a v e t h e c h o i c e ,

s e l e c t t h e b e s t s u i t i n g c o d e c w h e n e n c o d i n g t h e o r i g i n a l s o u r c e m a t e r i a l .

1 1 . 5 . 6 . S o u n d s e t t i n g s

I n g e n e r a l a l l k i n d s o f s o u n d p r o c e s s i n g w i l l n e e d m o r e C P U t i m e a n d t h e r e f o r e c o n s u m e

m o r e p o w e r . T h e l e s s s o u n d p r o c e s s i n g y o u u s e , t h e b e t t e r i t i s f o r t h e b a t t e r y r u n t i m e

( f o r o p t i o n s s e e s e c t i o n 6 ( p a g e 4 7 ) ) .




A p p e n d i x A . F i l e f o r m a t s 1 8 0





A . F i l e f o r m a t s

A . 1 . S u p p o r t e d l e f o r m a t s

I c o n F i l e T y p e E x t e n s i o n A c t i o n w h e n s e l e c t e d

D i r e c t o r y n o n e E n t e r t h e d i r e c t o r y

A u d i o l e v a r i o u s

( s e e A . 2 )

S t a r t p l a y i n g t h e l e a n d s h o w t h e

W P S

B o o k m a r k . b m a r k D i s p l a y a l l b o o k m a r k s f o r a n a u d i o

l e

G a m e o f L i f e . c e l l s S h o w t h e c o n g u r a t i o n w i t h t h e

R o c k l i f e p l u g i n

C o n g u r a t i o n F i l e . c f g L o a d t h e s e t t i n g s l e

C h i p 8 g a m e . c h 8 P l a y t h e C h i p 8 g a m e

C o l o u r s . c o l o u r s O p e n t h e c o l o u r s l e f o r e d i t i n g .

S e e s e c t i o n 1 1 . 1 . 4 ( p a g e 1 6 7 ) .

C u e s h e e t . c u e V i e w t h e c u e s h e e t l e

F o n t . f n t C h a n g e t h e u s e r i n t e r f a c e f o n t t o

t h i s o n e

R o c k b o x r m w a r e . g i g a b e a t L o a d t h e n e w r m w a r e w i t h R O L O

I m a g e . j p g V i e w t h e J P E G i m a g e

L i n k . l i n k D i s p l a y l i s t o f t a r g e t l e s a n d d i -

r e c t o r i e s ; s e l e c t i n g o n e j u m p s t o

t h e t a r g e t . S e e s e c t i o n 1 0 . 3 . 1

( p a g e 1 2 8 ) .

L a n g u a g e F i l e . l n g L o a d t h e l a n g u a g e l e

P l a y l i s t . m 3 u , . m 3 u 8 L o a d t h e p l a y l i s t a n d s t a r t p l a y i n g

t h e r s t l e

V i d e o . m p g , . m p e g ,

. m p v , . m 2 v

P l a y t h e M P E G 1 / 2 v i d e o

P l u g i n . r o c k S t a r t t h e p l u g i n

T e x t F i l e . t x t D i s p l a y t h e t e x t l e u s i n g t h e t e x t

v i e w e r p l u g i n

V o i c e l e . v o i c e A l l o w R o c k b o x t o s p e a k m e n u s

W h i l e P l a y i n g S c r e e n . w p s L o a d t h e n e w W P S d i s p l a y c o n g -

u r a t i o n





A . 2 . S u p p o r t e d a u d i o f o r m a t s

A . 2 . 1 . L o s s y C o d e c s

F o r m a t E x t e n s i o n N o t e s

A T S C A / 5 2 . a 5 2 , . a c 3 S u p p o r t s d o w n m i x i n g f o r p l a y -

b a c k o f 5 . 1 s t r e a m s i n s t e r e o .

A D X . a d x

A d v a n c e d A u d i o C o d i n g . m 4 a , . m 4 b ,

. m p 4

M P E G a u d i o . m p 1 , . m p a ,

. m p 2 , . m p 3

M u s e p a c k . m p c S u p p o r t s S V 7 a n d S V 8 i n

m o n o / s t e r e o

O G G / V o r b i s . o g g , . o g a P l a y b a c k o f s o m e o l d o o r 0

l e s m a y f a i l .

S o n y A u d i o . o m a , . a a 3

R e a l A u d i o . r m , . r a ,

. r m v b

S p e e x . s p x

D i a l o g i c t e l e p h o n y t y p e . v o x

W i n d o w s M e d i a A u d i o S t a n d a r d . w m a , . w m v ,

. a s f

W i n d o w s M e d i a A u d i o P r o f e s s i o n a l . w m a , . w m v ,

. a s f





A . 2 . 2 . L o s s l e s s C o d e c s


A u d i o I n t e r c h a n g e F i l e F o r m a t . a i f , . a i f f A I F F s u p p o r t s f o l l o w i n g f o r m a t s :

l i n e a r p c m 8 / 1 6 / 2 4 / 3 2 b i t .

I E E E o a t 3 2 / 6 4 b i t

I T U - T G . 7 1 1 a - l o w / µ

- l o w

Q u i c k T i m e I M A A D P C M

M o n k e y ' s A u d i o . a p e , . m a c - c 1 0 0 0 t o - c 3 0 0 0 l e s d e c o d e f a s t

e n o u g h t o b e u s e f u l .

S u n A u d i o . a u , . s n d

S u n A u d i o s u p p o r t s f o l l o w i n g f o r -

m a t s :

l i n e a r p c m 8 / 1 6 / 2 4 / 3 2 b i t .

I E E E o a t 3 2 / 6 4 b i t

I T U - T G . 7 1 1 a - l o w / µ - l o w

F r e e L o s s l e s s A u d i o . f l a c

A p p l e L o s s l e s s . m 4 a , . m p 4

S h o r t e n . s h n S e e k i n g n o t s u p p o r t e d .

T r u e A u d i o . t t a

W a v e 6 4 . w 6 4 W a v e / W a v e 6 4 s u p p o r t s f o l l o w i n g

f o r m a t s :

W a v e f o r m a u d i o f o r m a t . w a v l i n e a r p c m 8 / 1 6 / 2 4 / 3 2 b i t .

I E E E o a t 3 2 / 6 4 b i t

I T U - T G . 7 1 1 a - l o w / µ - l o w

M i c r o s o f t A D P C M

I n t e l D V I A D P C M ( I M A A D P C M )

2 / 3 / 4 / 5 b i t

D i a l o g i c O K I A D P C M

Y A M A H A A D P C M

A d o b e S W F A D P C M

W a v p a c k . w v





A . 2 . 3 . O t h e r C o d e c s


A t a r i S o u n d F o r m a t . c m c , . c m 3 ,

. c m r , . c m s ,

. d m c , . d l t ,

. m p t , . m p d

S y n t h e t i c m u s i c M o b i l e A p p l i c a t i o n F o r m a t . m m f S u p p o r t s

P C M / A D P C M o n l y

M O D . m o d

N E S S o u n d F o r m a t . n s f , . n s f e

A t a r i S A P . s a p

S o u n d I n t e r f a c e D e v i c e . s i d

S P C 7 0 0 . s p c




A p p e n d i x B . T h e m e T a g s 1 8 5

B . T h e m e T a g s

T h e m e i n g i s d i s c u s s e d i n d e t a i l i n s e c t i o n s e c t i o n 1 1 . 2 ( p a g e 1 7 0 ) , w h a t f o l l o w s i s a l i s t

o f t h e a v a i l a b l e t a g s .

N o t e : T h e b a r - t y p e t a g s ( s u c h a s % p b , % p v , % b l e t c . ) c a n b e f u r t h e r t h e m e d s e e bs e c t i o n B . 2 7 ( p a g e 1 9 7 ) .

B . 1 . S t a t u s B a r

T a g D e s c r i p t i o n

% w e D i s p l a y S t a t u s B a r

% w d H i d e S t a t u s B a r

% w i D i s p l a y t h e i n b u i l t S t a t u s B a r i n t h e c u r r e n t v i e w p o r t

T h e s e t a g s o v e r r i d e t h e p l a y e r s e t t i n g f o r t h e d i s p l a y o f t h e s t a t u s b a r . T h e y m u s t b e

n o t e d o n t h e i r o w n l i n e ( w h i c h w i l l n o t b e s h o w n i n t h e W P S ) .

B . 2 . H a r d w a r e C a p a b i l i t i e s


% c c C h e c k f o r p r e s e n c e o f a r e a l t i m e c l o c k , r e t u r n s c w h e n u s e d

u n c o n d i t i o n a l l y

% t p D o e s t h i s t a r g e t h a v e a r a d i o ?

% T p I n d i c a t e s t h a t t h e t a r g e t h a s a t o u c h s c r e e n

W i t h t h e a b o v e t a g s i t i s p o s s i b l e t o n d o u t a b o u t t h e p r e s e n c e o f c e r t a i n h a r d w a r e

a n d m a k e t h e t h e m e a d a p t t o i t . T h i s c a n b e v e r y u s e f u l f o r d e s i g n i n g a t h e m e t h a t

w o r k s o n m u l t i p l e t a r g e t s w i t h d i e r i n g h a r d w a r e c a p a b i l i t i e s , e . g . t a r g e t s t h a t d o a n d

d o n o t h a v e a c l o c k . W h e n u s e d c o n d i t i o n a l l y , t h e t r u e b r a n c h i s c o m p l e t e l y i g n o r e d i f

i t d o e s n o t a p p l y .

E x a m p l e : % ? c c < % c H : % c M | N o c l o c k d e t e c t e d >





B . 3 . I n f o r m a t i o n f r o m t h e t r a c k t a g s


% i a A r t i s t

% i c C o m p o s e r

% i A A l b u m A r t i s t

% i d A l b u m N a m e

% i G G r o u p i n g

% i g G e n r e N a m e

% i n T r a c k N u m b e r

% i t T r a c k T i t l e

% i C C o m m e n t

% i v I D 3 v e r s i o n ( 1 . 0 , 1 . 1 , 2 . 2 , 2 . 3 , 2 . 4 , o r e m p t y i f n o t a n I D 3 t a g )

% i y Y e a r

% i k D i s c N u m b e r

R e m e m b e r t h a t t h i s i n f o r m a t i o n i s n o t a l w a y s a v a i l a b l e , s o u s e t h e c o n d i t i o n a l s t o

s h o w a l t e r n a t e i n f o r m a t i o n i n p r e f e r e n c e t o a s s u m i n g .

T h e s e t a g s , w h e n w r i t t e n w i t h a c a p i t a l I ( e . g . % I a o r % I c ) , s h o w t h e i n f o r m a t i o n

f o r t h e n e x t s o n g t o b e p l a y e d .

B . 4 . V i e w p o r t s


% V ( x , y , [ w i d t h ] ,

[ h e i g h t ] , [ f o n t ] )

% V f ( [ f g c o l o u r ] )

% V b ( [ b g c o l o u r ] )

S e e s e c t i o n 1 1 . 2 . 2

% V l ( ' i d e n t i f i e r ' ,

. . . )

P r e l o a d s a v i e w p o r t f o r l a t e r d i s p l a y . ` i d e n t i e r ' i s a s i n g l e

l o w e r c a s e l e t t e r ( a - z ) a n d t h e ` . . . ' p a r a m e t e r s u s e t h e s a m e

l o g i c a s t h e % V t a g e x p l a i n e d a b o v e .

% V d ( ' i d e n t i f i e r ' ) D i s p l a y t h e ` i d e n t i e r ' v i e w p o r t . E . g . % ? C < % V d ( a ) | % V d ( b ) >

w i l l s h o w v i e w p o r t ` a ' i f a l b u m a r t i s f o u n d , a n d ` b ' i f i t i s n ' t .

% V i ( ' l a b e l ' , . . . ) D e c l a r e a C u s t o m U I V i e w p o r t . T h e ` . . . ' p a r a m e t e r s u s e t h e

s a m e l o g i c a s t h e % V t a g e x p l a i n e d a b o v e . S e e s e c t i o n 1 1 . 2 . 2 .

% V I ( ' l a b e l ' ) S e t t h e I n f o V i e w p o r t t o u s e t h e v i e w p o r t c a l l e d l a b e l , a s d e -

c l a r e d w i t h t h e p r e v i o u s t a g .

B . 5 . A d d i t i o n a l F o n t s


% F l ( ' i d ' , f i l e n a m e ) S e e s e c t i o n 1 1 . 2 . 4 .





B . 6 . P o w e r R e l a t e d I n f o r m a t i o n


% b l N u m e r i c b a t t e r y l e v e l i n p e r c e n t s . C a n a l s o b e u s e d i n

a c o n d i t i o n a l : % ? b l < - 1 | 0 | 1 | 2 | . . . | N > , w h e r e t h e v a l u e −1i s u s e d w h e n t h e b a t t e r y l e v e l i s n ' t k n o w n ( i t u s u a l l y i s ) .

T h e v a l u e N i s o n l y u s e d w h e n t h e b a t t e r y l e v e l i s e x -

a c t l y 1 0 0 p e r c e n t . A n i m a g e c a n a l s o b e u s e d , t h e p r o p o r -

t i o n o f t h e i m a g e s h o w n c o r r e s p o n d s t o t h e b a t t e r y l e v e l :

% b l ( x , y , [ w i d t h ] , [ h e i g h t ] , i m a g e . b m p )

% b v T h e b a t t e r y l e v e l i n v o l t s

% b t E s t i m a t e d b a t t e r y t i m e l e f t

% b p p i f t h e c h a r g e r i s c o n n e c t e d ( o n l y o n t a r g e t s t h a t c a n c h a r g e

b a t t e r i e s )

% b c c i f t h e u n i t i s c u r r e n t l y c h a r g i n g t h e b a t t e r y ( o n l y o n t a r g e t s

t h a t h a v e s o f t w a r e c h a r g e c o n t r o l o r m o n i t o r i n g )

% b s R e m a i n i n g t i m e o f t h e s l e e p t i m e r ( i f i t i s s e t )

B . 7 . I n f o r m a t i o n a b o u t t h e l e


% f b F i l e B i t r a t e ( i n k b p s )

% f c F i l e C o d e c ( e . g . M P 3 o r F L A C ) . T h i s t a g c a n a l s o b e u s e d

i n a c o n d i t i o n a l t a g : % ? f c < m p 1 | m p 2 | m p 3 | a i f f | w a v | o g g |

f l a c | m p c | a 5 2 | w a v p a c k | a l a c | a a c | s h n | s i d | a d x | n s f |

s p e e x | s p c | a p e | w m a | m o d | s a p | u n k n o w n > . T h e c o d e c o r d e r i s

a s f o l l o w s : M P 1 , M P 2 , M P 3 , A I F F , W A V , O g g V o r b i s ( O G G ) ,

F L A C , M P C , A C 3 , W a v P a c k ( W V ) , A L A C , A A C , S h o r t e n

( S H N ) , S I D , A D X , N S F , S p e e x , S P C , A P E , W M A , M O D ,

S A P .

% f f F i l e F r e q u e n c y ( i n H z )

% f k F i l e F r e q u e n c y ( i n k H z )

% f m F i l e N a m e

% f n F i l e N a m e ( w i t h o u t e x t e n s i o n )

% f p F i l e P a t h

% f s F i l e S i z e ( i n K i l o b y t e s )

% f v ( a v g ) i f v a r i a b l e b i t r a t e o r e m p t y s t r i n g i f c o n s t a n t b i t r a t e

% d ( N ) N - t h s e g m e n t f r o m t h e e n d o f t h e l e ' s d i r e c t o r y ( N c a n b e 1 ,

2 , 3 , . . . )

E x a m p l e f o r t h e % d ( N ) c o m m a n d s : I f t h e l e i s / R o c k / K e n t / I s o l a / 1 1 - 7 4 7 . m p 3 ,

% d ( 1 ) i s I s o l a , % d ( 2 ) i s K e n t a n d % d ( 3 ) i s R o c k .





T h e s e t a g s , w h e n w r i t t e n w i t h t h e r s t l e t t e r c a p i t a l i z e d ( e . g . % F n o r % D ( 2 ) ) , p r o d u c e

t h e i n f o r m a t i o n f o r t h e n e x t l e t o b e p l a y e d .

B . 8 . P l a y l i s t / S o n g I n f o


% p b P r o g r e s s B a r . T h i s w i l l r e p l a c e t h e e n t i r e l i n e w i t h a

p r o g r e s s b a r . Y o u c a n s e t t h e p o s i t i o n , w i d t h a n d h e i g h t o f

t h e p r o g r e s s b a r ( i n p i x e l s ) a n d l o a d a c u s t o m i m a g e f o r i t :

% p b ( x , y , [ w i d t h ] , [ h e i g h t ] , i m a g e . b m p )

% p x P e r c e n t a g e p l a y e d i n s o n g

% p c C u r r e n t t i m e i n s o n g

% p e T o t a l n u m b e r o f p l a y l i s t e n t r i e s

% p m P e a k M e t e r . T h e e n t i r e l i n e i s u s e d a s v o l u m e p e a k m e t e r .

% p L P e a k m e t e r f o r t h e l e f t c h a n n e l . C a n b e u s e d a s a v a l u e , a

c o n d i t i o n a l t a g o r a b a r t a g .

% p R P e a k m e t e r f o r t h e r i g h t c h a n n e l . C a n b e u s e d a s a v a l u e , a

c o n d i t i o n a l t a g o r a b a r t a g .

% p n P l a y l i s t n a m e ( w i t h o u t p a t h o r e x t e n s i o n )

% p p P l a y l i s t p o s i t i o n

% p r R e m a i n i n g t i m e i n s o n g

% p s s i f s h u e m o d e i s e n a b l e d

% p t T o t a l t r a c k t i m e

% p v C u r r e n t v o l u m e ( i n d B ) . C a n a l s o b e u s e d i n a c o n d i t i o n a l :

% ? p v < 0 | 1 | 2 | . . . | N >

0 i s u s e d f o r m u t e , t h e l a s t o p t i o n i s u s e d f o r v a l u e s g r e a t e r

t h a n z e r o . T h i s c a n a l s o b e u s e d l i k e % p b t o p r o v i d e a c o n -

t i n u o u s s c a l e : % p v ( x , y , [ w i d t h ] , [ h e i g h t ] , i m a g e . b m p )

% p S T r a c k i s s t a r t i n g . A n o p t i o n a l n u m b e r g i v e s h o w m a n y s e c o n d s

t h e t a g r e m a i n s t r u e f o r a f t e r t h e s t a r t o f t h e t r a c k . T h e d e -

f a u l t i s 1 0 s e c o n d s i f n o n u m b e r i s s p e c i e d . % ? p S ( 7 ) < i n t h e

f i r s t 7 s e c o n d s o f t r a c k | i n t h e r e s t o f t h e t r a c k >

% p E T r a c k i s e n d i n g . A n o p t i o n a l n u m b e r g i v e s h o w m a n y s e c o n d s

b e f o r e t h e e n d o f t h e t r a c k t h e t a g b e c o m e s t r u e . T h e d e f a u l t

i s 1 0 s e c o n d s i f n o n u m b e r i s s p e c i e d . % ? p E ( 7 ) < i n t h e l a s t

7 s e c o n d s o f t r a c k | i n t h e r e s t o f t h e t r a c k >

% S p C u r r e n t p l a y b a c k p i t c h





B . 9 . P l a y l i s t V i e w e r


% V p ( s t a r t , c o d e t o

r e n d e r )

D i s p l a y t h e p l a y l i s t v i e w e r i n t h e c u r r e n t v i e w p o r t .

• ` s t a r t ' i s t h e o s e t r e l a t i v e t o t h e c u r r e n t l y p l a y i n g t r a c k f o r t h e p l a y l i s t t o d i s p l a y

f r o m ( 0 t h e c u r r e n t t r a c k , 1 i s t h e n e x t t r a c k , e t c . ) .

• ` c o d e t o r e n d e r ' i s a l i n e o f s k i n c o d e w h i c h w i l l b e d i s p l a y e d f o r e a c h l i n e i n t h e

v i e w e r . A l l t e x t t a g s a r e s u p p o r t e ( i n c l u d i n g c o n d i t i o n a l s a n d s u b l i n e s )

T h e e n t i r e v i e w p o r t w i l l b e u s e d , s o d o n ' t e x p e c t o t h e r t a g s i n t h e s a m e v i e w p o r t t o

w o r k w e l l . S u p p o r t e d t a g s a r e % p p , a l l t a g s s t a r t i n g w i t h % i , m o s t t a g s s t a r t i n g w i t h

% f , % p t a n d % s .

E x a m p l e : % V p ( 1 , % p p - % i t , % p p - % f n )

D i s p l a y t h e p l a y l i s t p o s i t i o n , t h e n e i t h e r

t h e t r a c k t i t l e ( f r o m t h e t a g s ) o r t h e l e n a m e . T h e v i e w e r w i l l d i s p l a y a s m a n y t r a c k s a s

w i l l t i n t h e v i e w p o r t .

B . 1 0 . R u n t i m e D a t a b a s e


% r p S o n g p l a y c o u n t

% r r S o n g r a t i n g ( 0 - 1 0 ) . T h i s t a g c a n a l s o b e u s e d i n a c o n d i t i o n a l

t a g : % ? r r < 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 1 0 >

% r a A u t o s c o r e f o r t h e s o n g

B . 1 1 . S o u n d ( D S P ) s e t t i n g s


% S p C u r r e n t p l a y b a c k p i t c h

% x f C r o s s f a d e s e t t i n g , i n t h e o r d e r : O , A u t o S k i p , M a n S k i p ,

S h u e , S h u e a n d M a n S k i p , A l w a y s

% r g R e p l a y G a i n v a l u e i n u s e ( x . y d B ) . I f u s e d

a s a c o n d i t i o n a l , R e p l a y g a i n t y p e i n u s e :

% ? r g < O f f | T r a c k | A l b u m | T r a c k S h u f f l e | A l b u m S h u f f l e | N o

t a g >





B . 1 2 . H o l d


% m h h i f t h e m a i n u n i t k e y s a r e l o c k e d

B . 1 3 . V i r t u a l L E D


% l h h i f t h e h a r d d i s k i s a c c e s s e d

B . 1 4 . R e p e a t M o d e


% m m R e p e a t m o d e , 0 - 4 , i n t h e o r d e r : O , A l l , O n e , S h u e , A - B

E x a m p l e : % ? m m < O f f | A l l | O n e | S h u f f l e | A - B >

B . 1 5 . P l a y b a c k M o d e


% m p P l a y s t a t u s , 0 - 4 , i n t h e o r d e r : S t o p , P l a y , P a u s e , F a s t F o r w a r d ,

R e w i n d , R e c o r d i n g , R e c o r d i n g p a u s e d , F M R a d i o p l a y i n g , F M

R a d i o m u t e d

E x a m p l e : % ? m p < S t o p | P l a y | P a u s e | F f w d | R e w | R e c | R e c p a u s e | F M | F M p a u s e >

B . 1 6 . C u r r e n t S c r e e n


% c s T h e c u r r e n t s c r e e n , 1 - 5 , i n t h e o r d e r : M e n u s , W P S , R e c o r d i n g

s c r e e n , F M R a d i o s c r e e n , C u r r e n t P l a y l i s t s c r e e n

T h e t a g c a n a l s o b e u s e d a s t h e s w i t c h i n a c o n d i t i o n a l t a g . F o r p l a y e r s w i t h o u t s o m e

c a p a b i l i t i e s ( e . g . h a v i n g n o F M r a d i o ) s o m e v a l u e s w i l l b e n e v e r y i e l d e d .

E x a m p l e : Y o u a r e i n t h e % ? c s < M a i n m e n u | W P S | R e c o r d i n g s c r e e n | F M R a d i o s c r e e n >





B . 1 7 . L i s t T i t l e ( . s b s o n l y )


% L t T i t l e t e x t . S h o u l d b e u s e d i n a c o n d i t i o n a l s o t h a t n o n - l i s t

s c r e e n s d o n ' t s h o w a t i t l e w h e n t h e y s h o u l d n ' t

% L i T i t l e i c o n . T h i s u s e s t h e s a m e o r d e r a s c u s t o m i c o n s ( s e e

ZC u s t o m I c o n s i n t h e w i k i ) e x c e p t t h a t h e r e 0 i s n o i c o n

T h i s t a g c a n b e u s e d t o g i v e c u s t o m f o r m a t t i n g t o l i s t t i t l e s . D e n e a v i e w p o r t w i t h

t h e f o n t a n d f o r m a t t i n g d e s i r e d , a n d t h e n u s e % ? L t < % L t > t o d i s p l a y t h e t i t l e w i t h i n t h e

v i e w p o r t . I f % L t i s p r e s e n t a n y w h e r e i n t h e . s b s , t h e n t h e % V i v i e w p o r t w i l l n o t s h o w

t h e t i t l e .

B . 1 8 . C h a n g i n g V o l u m e


% m v ( t ) v i f t h e v o l u m e i s b e i n g c h a n g e d

T h e t a g p r o d u c e s t h e l e t t e r v w h i l e t h e v o l u m e i s b e i n g c h a n g e d a n d s o m e a m o u n t o f

t i m e a f t e r t h a t , i . e . a f t e r t h e v o l u m e b u t t o n h a s b e e n r e l e a s e d . T h e o p t i o n a l p a r a m e t e r

t s p e c i e s t h a t a m o u n t o f t i m e , i n s e c o n d s . I f i t i s n o t s p e c i e d , 1 s e c o n d i s a s s u m e d .

T h e t a g c a n b e u s e d a s t h e s w i t c h i n a c o n d i t i o n a l t a g t o d i s p l a y d i e r e n t t h i n g s

d e p e n d i n g o n w h e t h e r t h e v o l u m e i s b e i n g c h a n g e d . I t c a n p r o d u c e n e a t e e c t s w h e n

u s e d w i t h c o n d i t i o n a l v i e w p o r t s .

E x a m p l e : % ? m v ( 2 . 5 ) < V o l u m e c h a n g i n g | % p v >

T h e e x a m p l e a b o v e w i l l d i s p l a y t h e t e x t V o l u m e c h a n g i n g i f t h e v o l u m e i s b e i n g

c h a n g e d a n d 2 . 5 s e c o n d s a f t e r t h e v o l u m e b u t t o n h a s b e e n r e l e a s e d . A f t e r t h a t , i t w i l l

d i s p l a y t h e v o l u m e v a l u e .

B . 1 9 . S e t t i n g s


% S t ( < s e t t i n g

n a m e > )

T h e v a l u e o f t h e R o c k b o x s e t t i n g w i t h t h e s p e c i e d n a m e . S e e

s e c t i o n C ( p a g e 1 9 9 ) f o r t h e l i s t o f t h e a v a i l a b l e s e t t i n g s .

E x a m p l e s :

1 . A s a s i m p l e t a g : % S t ( s k i p l e n g t h )

2 . A s a c o n d i t i o n a l : % ? S t ( e q e n a b l e d ) < E q i s e n a b l e d | E q i s d i s a b l e d >


http://www.rockbox.org/wiki/CustomIcons




B . 2 0 . I m a g e s


% X ( f i l e n a m e . b m p ) L o a d a n d s e t a b a c k d r o p i m a g e f o r t h e W P S . T h i s i m a g e m u s t

b e e x a c t l y t h e s a m e s i z e a s y o u r L C D .

% x ( n , f i l e n a m e , x , y ) L o a d a n d d i s p l a y a n i m a g e

n : i m a g e I D ( a - z a n d A - Z ) f o r l a t e r r e f e r e n c i n g i n % x d

f i l e n a m e : l e n a m e r e l a t i v e t o / . r o c k b o x / a n d i n c l u d i n g

. b m p

x : x c o o r d i n a t e

y : y c o o r d i n a t e .

% x l ( n , f i l e n a m e , x , y ,

[ n i m a g e s ] )

P r e l o a d a n i m a g e f o r l a t e r d i s p l a y ( u s e f u l f o r w h e n y o u r i m -

a g e s a r e d i s p l a y e d c o n d i t i o n a l l y ) .

n : i m a g e I D ( a - z a n d A - Z ) f o r l a t e r r e f e r e n c i n g i n % x d

f i l e n a m e : l e n a m e r e l a t i v e t o / . r o c k b o x / a n d i n c l u d i n g

. b m p

I f t h e l e n a m e i s _ _ l i s t _ i c o n s _ _ t h e l i s t i c o n b i t m a p w i l l

b e u s e d i n s t e a d


y : y c o o r d i n a t e

n i m a g e s : ( o p t i o n a l ) n u m b e r o f s u b - i m a g e s ( t i l e d v e r t i c a l l y , o f

t h e s a m e h e i g h t ) c o n t a i n e d i n t h e b i t m a p . D e f a u l t i s 1 .

% x d ( n [ i ] [ , t a g ]

[ , o f f s e t ] )

D i s p l a y a p r e l o a d e d i m a g e . n : i m a g e I D ( a - z a n d A - Z ) a s i t

w a s s p e c i e d i n % x o r % x l

i : ( o p t i o n a l ) n u m b e r o f t h e s u b - i m a g e t o d i s p l a y ( a - z f o r 1 - 2 6

a n d A - Z f o r 2 7 - 5 2 ) . ( i g n o r e d w h e n t a g i s u s e d ) B y d e f a u l t t h e

r s t ( i . e . t o p m o s t ) s u b - i m a g e w i l l b e u s e d .

t a g : ( o p t i o n a l ) A n o t h e r t a g t o c a l c u l a t e t h e s u b i m a g e f r o m

e . g % x d ( A , % m h ) w o u l d u s e t h e r s t s u b i m a g e w h e n % m h i s o n

a n d t h e s e c o n d w h e n i t i s o

o f f s e t : ( o p t i o n a l ) A d d t h i s n u m b e r t o t h e v a l u e f r o m t h e t a g

w h e n c h o s i n g t h e s u b i m a g e ( m a y b e n e g a t i v e )

E x a m p l e s :

1 . L o a d a n d d i s p l a y t h e i m a g e / . r o c k b o x / b g . b m p w i t h I D a a t 3 7 , 1 0 9 :

% x ( a , b g . b m p , 3 7 , 1 0 9 )

2 . L o a d a b i t m a p s t r i p c o n t a i n i n g 5 v o l u m e i c o n i m a g e s ( a l l t h e s a m e s i z e ) w i t h i m a g e

I D M , a n d t h e n r e f e r e n c e t h e i n d i v i d u a l s u b - i m a g e s i n a c o n d i t i o n a l :

% x l ( M , v o l u m e . b m p , 1 3 4 , 1 5 3 , 5 )

% ? p v < % x d ( M a ) | % x d ( M b ) | % x d ( M c ) | % x d ( M d ) | % x d ( M e ) >

N o t e : b





• T h e i m a g e s m u s t b e i n B M P f o r m a t

• T h e i m a g e t a g m u s t b e o n i t s o w n l i n e

• T h e I D i s c a s e s e n s i t i v e , g i v i n g 5 2 d i e r e n t I D ' s

• T h e s i z e o f t h e L C D s c r e e n f o r e a c h p l a y e r v a r i e s . S e e t a b l e b e l o w f o r a p p r o p r i a t e

s i z e s o f e a c h d e v i c e . T h e x a n d y c o o r d i n a t e s m u s t r e s p e c t e a c h o f t h e p l a y e r ' s

l i m i t s .

B . 2 1 . A l b u m A r t

R o c k b o x a l l o w s y o u t o p u t t h e a l b u m a r t , o r a n o t h e r i m a g e r e l a t e d t o t h e m u s i c o n y o u r

p l a y e r t o d i s p l a y i t i n t h e P i c t u r e F l o w p l u g i n o r i n t h e t h e m e . F o r t h i s f e a t u r e t o w o r k ,

t h e r e a r e a f e w r e q u i r e m e n t s .

B . 2 1 . 1 . L i m i t a t i o n s

R o c k b o x d o e s n o t s u p p o r t a l b u m a r t e m b e d d e d i n y o u r l e s ' t a g s , a n d w i l l i n s t e a d l o o k

f o r a p i c t u r e l o c a t e d o n d i s k . I n a d d i t i o n t o t h i s , t h e p i c t u r e s m u s t b e i n e i t h e r B M P

o r J P E G f o r m a t . R o c k b o x d o e s n o t s u p p o r t R L E - c o m p r e s s e d B M P l e s , n o r d o e s i t

s u p p o r t p r o g r e s s i v e a n d m u l t i - s c a n J P E G l e s . J P E G l e s m u s t c o n s i s t o f a s i n g l e s c a n

w i t h i n t e r l e a v e d c o m p o n e n t s , a s p r o g e s s i v e a n d m u l t i - s c a n i m a g e s r e q u i r e m u c h m o r e

m e m o r y t o d e c o d e .

B . 2 1 . 2 . W h e r e t o p u t a l b u m a r t

T h e p i c t u r e s c a n b e n a m e d a n u m b e r o f d i e r e n t w a y s , a n d p l a c e d t o a n u m b e r o f d i e r e n t

l o c a t i o n s . Y o u c a n h a v e p i c t u r e s s p e c i c t o t h e l e o r t h e a l b u m o r u s e a g e n e r i c p i c t u r e .

Y o u c a n p l a c e t h e p i c t u r e i n t h e s a m e d i r e c t o r y a s t h e l e , i n t h e p a r e n t d i r e c t o r y o r i n

a x e d d i r e c t o r y n a m e d / . r o c k b o x / a l b u m a r t / . T h e o r d e r R o c k b o x u s e s w h e n l o o k i n g

f o r a p i c t u r e i s a s f o l l o w s ( a l i s t i n b r a c e s m e a n s t h a t t h o s e l e e x t e n s i o n s a r e t r i e d i n

t h a t o r d e r ) :

1 . . / f i l e n a m e . { j p e g , j p g , b m p }

2 . . / a l b u m t i t l e . { j p e g , j p g , b m p }

3 . . / c o v e r . { j p e g , j p g , b m p }

4 . . / f o l d e r . j p g

5 . / . r o c k b o x / a l b u m a r t / a l b u m a r t i s t - a l b u m t i t l e . { j p e g , j p g , b m p }

6 . . . / a l b u m t i t l e . { j p e g , j p g , b m p }

7 . . . / c o v e r . { j p e g , j p g , b m p }





T h e f o l l o w i n g c h a r a c t e r s w i l l b e r e p l a c e d w i t h a n u n d e r s c o r e ( _ ) w h e n l o o k i n g f o r

a l b u m t i t l e . b m p o r a l b u m a r t i s t - a l b u m t i t l e . b m p : \ / : < > ? * | . D o u b l e q u o t e s w i l l b e

r e p l a c e d b y s i n g l e q u o t e s . I f n o a l b u m a r t i s t i s s e t , a r t i s t w i l l b e u s e d i n s t e a d . S e e

ZA l b u m A r t i n t h e w i k i f o r p r o g r a m s t h a t w i l l h e l p y o u a u t o m a t e t h e p r o c e s s o f p u t t i n g

a l b u m a r t o n y o u r p l a y e r .

B . 2 1 . 3 . H o w t o d i s p l a y t h e a l b u m a r t

O n c e t h e a l b u m a r t l e s a r e p r e s e n t o n y o u r p l a y e r , t h e y c a n b e d i s p l a y e d a s f o l l o w s .


% C l ( x , y , [ m a x w i d t h ] ,

[ m a x h e i g h t ] ,

h o r _ a l i g n ,

v e r t _ a l i g n )

D e n e t h e s e t t i n g s f o r a l b u m a r t


y : y c o o r d i n a t e

m a x w i d t h : M a x i m u m h e i g h t

m a x h e i g h t : M a x i m u m w i d t h

h o r _ a l i g n : H o r i z o n t a l a l i g n m e n t , e n t e r a s ` l ' , ` c ' o r ` r ' f o r l e f t ,

c e n t r e o r r i g h t . C e n t r e i s d e f a u l t

v e r t _ a l i g n : V e r t i c a l a l i g n m e n t , e n t e r a s ` t ' , ` c ' o r ` b ' f o r t o p ,

c e n t r e o r b o t t o m . C e n t r e i s d e f a u l t

% C d D i s p l a y t h e a l b u m a r t a s c o n g u r e d .

% C U s e i n a c o n d i t i o n a l t o d e t e r m i n e i f a n i m a g e i s a v a i l a b l e .

T h e p i c t u r e w i l l b e r e s c a l e d , p r e s e r v i n g a s p e c t r a t i o t o t t h e g i v e n m a x w i d t h a n d

m a x h e i g h t . I f t h e a s p e c t r a t i o d o e s n ' t m a t c h t h e c o n g u r e d v a l u e s , t h e p i c t u r e w i l l b e

p l a c e d a c c o r d i n g t o t h e a l i g n m e n t a g s .

E x a m p l e s :

1 . L o a d a l b u m a r t a t p o s i t i o n 2 0 , 4 0 a n d d i s p l a y i t w i t h o u t r e s i z i n g :

% C l ( 2 0 , 4 0 )

2 . L o a d a l b u m a r t a t p o s i t i o n 0 , 2 0 a n d r e s i z e i t t o b e a t m o s t 1 0 0 ×1 0 0 p i x e l s . I f t h e

i m a g e i s n ' t s q u a r e , a l i g n i t t o t h e b o t t o m - r i g h t c o r n e r :

% C l ( 0 , 2 0 , 1 0 0 , 1 0 0 , r , b )


http://www.rockbox.org/wiki/AlbumArt




B . 2 2 . A l i g n m e n t a n d l a n g u a g e d i r e c t i o n


% a l A l i g n t h e t e x t l e f t

% a L A l i g n t h e t e x t l e f t , o r t o t h e r i g h t i f R T L l a n g u a g e i s i n u s e

% a c C e n t r e t h e t e x t

% a r A l i g n t h e t e x t r i g h t

% a R A l i g n t h e t e x t r i g h t , o r t o t h e l e f t i f R T L l a n g u a g e i s i n u s e

% a x T h e n e x t t a g s h o u l d f o l l o w t h e s e t l a n g u a g e d i r e c t i o n . W h e n

p r e p e n d e d t o a v i e w p o r t d e c l a r a t i o n , t h e v i e w p o r t w i l l b e h o r i -

z o n t a l l y m i r r o r e d i f t h e u s e r l a n g u a g e i s s e t t o a R T L l a n g u a g e .

C u r r e n t l y t h e % C l , % V a n d % V l t a g s s u p p o r t t h i s .

% S r U s e a s a c o n d i t i o n a l t o d e n e o p t i o n s f o r l e f t t o r i g h t , o r r i g h t

t o l e f t l a n g u a g e s . % ? S r < R T L | L T R >

A l l a l i g n m e n t t a g s m a y b e p r e s e n t i n o n e l i n e , b u t t h e y n e e d t o b e i n t h e o r d e r l e f t

c e n t r e r i g h t . I f t h e a l i g n e d t e x t s o v e r l a p , t h e y a r e m e r g e d .

E x a m p l e : % a x % V ( . . . )

B . 2 3 . C o n d i t i o n a l T a g s


% ? x x < t r u e | f a l s e > I f / E l s e : E v a l u a t e f o r t r u e o r f a l s e c a s e

% ? x x < a l t 1 | a l t 2 |

a l t 3 | . . . | e l s e >

E n u m e r a t i o n s : E v a l u a t e f o r r s t / s e c o n d / t h i r d / . . . / l a s t

c o n d i t i o n

% i f ( t a g ,

o p e r a t o r ,

o p e r a n d , [ o p t i o n

c o u n t ] )

A l l o w s v e r y s i m p l e c o m p a r i s o n s w i t h o t h e r t a g s .

t a g : t h e t a g t o c h e c k a g a i n s t .

o p e r a t o r : t h e c o m p a r i s o n t o p e r f o r m - p o s s i b l e o p t i o n s a r e

= , ! = , > , > = , < , < =

o p e r a n d : e i t h e r a s e c o n d t a g , a n u m b e r , o r t e x t .

[ o p t i o n c o u n t ] : o p t i o n a l p a r a m e t e r u s e d t o s e l e c t w h i c h p a -

r a m e t e r o f a t a g t o u s e w h e n t h e t a g h a s m u l t i p l e o p t i o n s , e . g .

% ? p v < a | b | c | d >

E x a m p l e s o f t h e % i f t a g :

% ? i f ( % p v , > = , 0 ) < C l i p p i n g p o s s i b l e | V o l u m e O K > w i l l d i s p l a y C l i p p i n g p o s s i b l e

i f t h e v o l u m e i s h i g h e r t h a n o r e q u a l t o 0 d B , V o l u m e O K i f i t i s l o w e r .

% ? i f ( % i a , = , % I a ) < s a m e a r t i s t > t h i s a r t i s t a n d t h e n e x t a r t i s t a r e t h e s a m e .

N o t e : W h e n p e r f o r m i n g a c o m p a r i s o n a g a i n s t a s t r i n g t a g s u c h a s % i a , o n l y = a n d ! = b





w o r k , a n d t h e c o m p a r i s o n i s n o t c a s e s e n s i t i v e .

B . 2 4 . S u b l i n e T a g s


% t ( t i m e ) S e t t h e s u b l i n e d i s p l a y c y c l e t i m e ( % t ( 5 ) o r % t ( 3 . 4 ) f o r m a t s )

; S p l i t i t e m s o n a l i n e i n t o s e p a r a t e s u b l i n e s

A l l o w s g r o u p i n g o f s e v e r a l i t e m s ( s u b l i n e s ) o n t o o n e l i n e , w i t h t h e d i s p l a y c y c l i n g

r o u n d t h e d e n e d s u b l i n e s . S e e s e c t i o n 1 1 . 2 . 4 ( p a g e 1 7 4 ) f o r d e t a i l s .

B . 2 5 . T i m e a n d D a t e


% c d D a y o f m o n t h f r o m 0 1 t o 3 1

% c e Z e r o p a d d e d d a y o f m o n t h f r o m 1 t o 3 1

% c f A c o n d i t i o n a l f o r 1 2 / 2 4 h o u r f o r m a t .

% ? c f < 2 4 h o u r s t u f f | 1 2 h o u r s t u f f >

% c H Z e r o p a d d e d h o u r f r o m 0 0 t o 2 3 ( 2 4 h o u r f o r m a t )

% c k H o u r f r o m 0 t o 2 3 ( 2 4 h o u r f o r m a t )

% c I Z e r o p a d d e d h o u r f r o m 0 1 t o 1 2 ( a m / p m f o r m a t )

% c l H o u r f r o m 1 t o 1 2 ( a m / p m f o r m a t )

% c m M o n t h f r o m 0 1 t o 1 2

% c M M i n u t e s

% c S S e c o n d s

% c y 2 - d i g i t y e a r

% c Y 4 - d i g i t y e a r

% c P C a p i t a l A M / P M

% c p L o w e r c a s e a m / p m

% c a W e e k d a y n a m e

% c b M o n t h n a m e

% c u D a y o f w e e k f r o m 1 t o 7 , 1 i s M o n d a y

% c w D a y o f w e e k f r o m 0 t o 6 , 0 i s S u n d a y

B . 2 6 . T e x t T r a n s l a t i o n


% S x ( E n g l i s h ) D i s p l a y t h e t r a n s l a t i o n o f E n g l i s h i n t h e c u r r e n t l a n g u a g e

• E n g l i s h m u s t b e a p h r a s e u s e d i n t h e l a n g u a g e l e .





• I t s h o u l d m a t c h t h e S o u r c e : l i n e i n t h e l a n g u a g e l e .

N o t e : c h e c k w p s c a n n o t v e r i f y t h a t t h e s t r i n g i s c o r r e c t , s o p l e a s e c h e c k o n e i t h e r t h e bs i m u l a t o r o r o n t a r g e t .

B . 2 7 . B a r T a g s

S o m e t a g s c a n b e u s e d t o d i s p l a y a b a r w h i c h d r a w s a c c o r d i n g t o t h e v a l u e o f t h e t a g .

T o u s e t h e s e t a g s l i k e a b a r y o u n e e d t o u s e t h e f o l l o w i n g p a r a m e t e r s ( % X X s h o u l d b e

r e p l a c e d w i t h t h e a c t u a l t a g ) .


% X X ( x , y ,

w i d t h , h e i g h t ,

[ o p t i o n s ] )

D r a w t h e s p e c i e d t a g a s a b a r

x : x c o - o r d i n a t e a t w h i c h t o s t a r t d r a w i n g t h e b a r .

y : y c o - o r d i n a t e a t w h i c h t o s t a r t d r a w i n g t h e b a r .

w i d t h : w i d t h o f t h e b a r ( - f o r t h e f u l l v i e w p o r t w i d t h ) .

h e i g h t : h e i g h t o f t h e b a r ( - t o s e t t o t h e f o n t h e i g h t f o r h o r i -

z o n t a l b a r s a n d t o t h e v i e w p o r t h e i g h t f o r v e r t i c a l b a r s ) .

o p t i o n s : a n y o f t h e o p t i o n s s e t o u t b e l o w .

B . 2 7 . 1 . O p t i o n s

i m a g e t h e n e x t o p t i o n i s e i t h e r t h e l e n a m e o r i m a g e l a b e l t o u s e f o r t h e l l i m a g e .

h o r i z o n t a l f o r c e t h e b a r t o b e d r a w n h o r i z o n t a l l y .

v e r t i c a l f o r c e t h e b a r t o b e d r a w n v e r t i c a l l y .

i n v e r t i n v e r t t h e d r a w d i r e c t i o n ( i . e . r i g h t t o l e f t , o r t o p t o b o t t o m ) .

s l i d e r d r a w a p r e l o a d e d i m a g e o v e r t h e t o p o f t h e b a r s o t h a t t h e c e n t r e o f t h e i m a g e

m a t c h e s t h e c u r r e n t p o s i t i o n . T h i s m u s t b e f o l l o w e d b y t h e l a b e l o f t h e d e s i r e d

i m a g e .

b a c k d r o p d r a w a p r e l o a d e d i m a g e u n d e r t h e b a r . T h e f u l l i m a g e w i l l b e d i s p l a y e d a n d

m u s t b e t h e s a m e s i z e a s t h e b a r . T h i s m u s t b e f o l l o w e d b y t h e l a b e l o f t h e d e s i r e d

i m a g e .

n o l l d o n ' t d r a w t h e b a r , o n l y i t s f r a m e ( f o r u s e w i t h t h e s l i d e r o p t i o n ) .

n o b a r d o n ' t d r a w t h e b a r o r i t s f r a m e ( f o r u s e w i t h t h e s l i d e r o p t i o n ) .

E x a m p l e : % p b ( 0 , 0 , - , - , - , n o f i l l , s l i d e r , s l i d e r _ i m a g e , i n v e r t ) d r a w a h o r -

i z o n t a l p r o g r e s s b a r w h i c h d o e s n ' t l l a n d d r a w s t h e i m a g e s l i d e r _ i m a g e w h i c h m o v e s

r i g h t t o l e f t .





N o t e : I f t h e s l i d e r o p t i o n i s u s e d , t h e b a r w i l l b e s h r u n k s o t h a t t h e s l i d e r t s i n s i d e t h e bs p e c i e d w i d t h a n d h e i g h t .

B . 2 8 . O t h e r T a g s


% ( T h e c h a r a c t e r ` ( '

% ) T h e c h a r a c t e r ` ) '

% , T h e c h a r a c t e r ` , '

% % T h e c h a r a c t e r ` % '

% < T h e c h a r a c t e r ` < '

% | T h e c h a r a c t e r ` | '

% > T h e c h a r a c t e r ` > '

% ; T h e c h a r a c t e r ` ; '

% # T h e c h a r a c t e r ` # '

% s I n d i c a t e t h a t t h e l i n e s h o u l d s c r o l l . C a n o c c u r a n y w h e r e i n a

l i n e ( g i v e n t h a t t h e t e x t i s d i s p l a y e d ; s e e c o n d i t i o n a l s a b o v e ) .

Y o u c a n s p e c i f y u p t o t e n s c r o l l i n g l i n e s . S c r o l l i n g l i n e s c a n

n o t c o n t a i n d y n a m i c c o n t e n t s u c h a s t i m e r s , p e a k m e t e r s o r

p r o g r e s s b a r s .




A p p e n d i x C . C o n f i g f i l e o p t i o n s 1 9 9

C . C o n g l e o p t i o n s

S e t t i n g A l l o w e d V a l u e s U n i t

v o l u m e d B

b a s s d B

t r e b l e d B

b a l a n c e - 1 0 0 t o + 1 0 0 %

c h a n n e l s s t e r e o , m o n o , c u s t o m , m o n o l e f t ,

m o n o r i g h t , k a r a o k e

N / A

s t e r e o _ w i d t h 0 t o 2 5 0 %

s h u e o n , o N / A

r e p e a t o , a l l , o n e , s h u e , a b N / A

p l a y s e l e c t e d o n , o N / A

p a r t y m o d e o n , o N / A

s c a n m i n s t e p 1 , 2 , 3 , 4 , 5 , 6 , 8 , 1 0 , 1 5 , 2 0 , 2 5 , 3 0 ,

4 5 , 6 0

s

s e e k a c c e l e r a t i o n v e r y f a s t , f a s t , n o r m a l , s l o w , v e r y

s l o w

N / A

a n t i s k i p 5 s , 1 5 s , 3 0 s , 1 m i n , 2 m i n , 3 m i n ,

5 m i n , 1 0 m i n

N / A

v o l u m e f a d e o n , o N / A

s o r t c a s e o n , o N / A

s h o w l e s a l l , s u p p o r t e d , m u s i c , p l a y l i s t s N / A

s h o w l e n a m e e x t s o , o n , u n k n o w n , v i e w _ a l l N / A

f o l l o w p l a y l i s t o n , o N / A

p l a y l i s t v i e w e r i c o n s o n , o N / A

p l a y l i s t v i e w e r i n d i c e s o n , o N / A

p l a y l i s t v i e w e r t r a c k

d i s p l a y

t r a c k n a m e , f u l l p a t h N / A

r e c u r s i v e d i r e c t o r y i n s e r t o n , o , a s k N / A

s c r o l l s p e e d 1 t o 2 5 H z

s c r o l l d e l a y 0 t o 2 5 0 0 m s

s c r o l l s t e p d e v i s e a w a y t o g e t r a n g e s

f r o m c o n g - * . h

p i x e l s

s c r e e n s c r o l l s t e p d e v i s e a w a y t o g e t r a n g e s

f r o m c o n g - * . h

p i x e l s

S c r e e n S c r o l l s O u t O f

V i e w

o n , o N / A






b i d i r l i m i t 0 t o 2 0 0 % s c r e e n

s c r o l l p a g i n a t e d o n , o N / A

h o l d _ l r _ f o r _ s c r o l l _ i n _ l i s t o n , o N / A

s h o w p a t h i n b r o w s e r o , c u r r e n t d i r e c t o r y , f u l l p a t h N / A

c o n t r a s t 0 t o 6 3 N / A

b a c k l i g h t t i m e o u t o , o n , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 1 0 ,

1 5 , 2 0 , 2 5 , 3 0 , 4 5 , 6 0 , 9 0 , 1 2 0

s

b a c k l i g h t t i m e o u t p l u g g e d o , o n , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 1 0 ,

1 5 , 2 0 , 2 5 , 3 0 , 4 5 , 6 0 , 9 0 , 1 2 0

s

b a c k l i g h t l t e r s r s t

k e y p r e s s

o n , o N / A

b a c k l i g h t o n b u t t o n h o l d n o r m a l , o , o n N / A

c a p t i o n b a c k l i g h t o n , o N / A

b r i g h t n e s s d e v i s e a w a y t o g e t r a n g e s

f r o m c o n g - * . h

N / A

d i s k s p i n d o w n 3 t o 2 5 4 s

b a t t e r y c a p a c i t y d e v i s e a w a y t o g e t r a n g e s

f r o m c o n g - * . h

m A h

c a r a d a p t e r m o d e o n , o N / A

i d l e p o w e r o o , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 1 0 , 1 5 ,

3 0 , 4 5 , 6 0

m i n

m a x l e s i n p l a y l i s t 1 0 0 0 - 3 2 0 0 0 N / A

m a x l e s i n d i r 5 0 - 1 0 0 0 0 N / A

l a n g / p a t h / l e n a m e . l n g N / A

w p s / p a t h / l e n a m e . w p s N / A

a u t o c r e a t e b o o k m a r k s o , o n N / A

a u t o l o a d b o o k m a r k s o , o n N / A

u s e

m o s t - r e c e n t - b o o k m a r k s

o , o n N / A

p a u s e o n h e a d p h o n e

u n p l u g

o , p a u s e , p a u s e a n d r e s u m e N / A

r e w i n d d u r a t i o n o n p a u s e 0 t o 1 5 s

d i s a b l e a u t o r e s u m e i f

p h o n e s n o t p r e s e n t

o , o n N / A

L a s t . f m L o g g i n g o , o n N / A

t a l k d i r o , n u m b e r , s p e l l N / A

t a l k d i r c l i p o , o n N / A

t a l k l e o , n u m b e r , s p e l l N / A

t a l k l e c l i p o , o n N / A

t a l k l e t y p e o , o n N / A

t a l k m e n u o , o n N / A

A n n o u n c e B a t t e r y L e v e l o , o n N / A






h o t k e y w p s o , v i e w p l a y l i s t , s h o w t r a c k i n f o ,

p i t c h s c r e e n , o p e n w i t h , d e l e t e

N / A

h o t k e y t r e e o , o p e n w i t h , d e l e t e , i n s e r t , i n s e r t

s h u e d

N / A

s o r t l e s a l p h a , o l d e s t , n e w e s t , t y p e N / A

s o r t d i r s a l p h a , o l d e s t , n e w e s t N / A

s o r t i n t e r p r e t n u m b e r d i g i t s , n u m b e r s N / A

t a g c a c h e _ a u t o u p d a t e o n , o N / A

w a r n w h e n e r a s i n g

d y n a m i c p l a y l i s t

o n , o N / A

c u e s h e e t s u p p o r t o n , o N / A

f o l d e r n a v i g a t i o n o , o n , r a n d o m N / A

g a t h e r r u n t i m e d a t a o , o n N / A

s k i p l e n g t h o u t r o , t r a c k , 1 s , 2 s , 3 s , 5 s , 7 s , 1 0 s ,

1 5 s , 2 0 s , 1 m i n , 9 0 s , 2 m i n , 3 m i n ,

5 m i n , 1 0 m i n , 1 5 m i n

N / A

p r e v e n t t r a c k s k i p o n , o N / A

s t a r t i n s c r e e n p r e v i o u s , r o o t , l e s , d B , w p s ,

m e n u , b o o k m a r k s

N / A

p l a y l i s t c a t a l o g d i r e c t o r y / p a t h / t o / d i r N / A

l i s t _ a c c e l _ s t a r t _ d e l a y 0 t o 1 0 m s

l i s t _ a c c e l _ w a i t 1 t o 1 0 s

r e p l a y g a i n t y p e t r a c k , a l b u m , t r a c k s h u e , o N / A

r e p l a y g a i n n o c l i p o n , o N / A

r e p l a y g a i n p r e a m p - 1 2 0 t o 1 2 0 0 . 1 d B

c r o s s f a d e o , a u t o t r a c k c h a n g e , m a n t r a c k

s k i p , s h u e , s h u e o r m a n t r a c k

s k i p , a l w a y s

N / A

c r o s s f a d e f a d e i n d e l a y 0 t o 7 s

c r o s s f a d e f a d e o u t d e l a y 0 t o 7 s

c r o s s f a d e f a d e i n d u r a t i o n 0 t o 1 5 s

c r o s s f a d e f a d e o u t

d u r a t i o n

0 t o 1 5 s

c r o s s f a d e f a d e o u t m o d e c r o s s f a d e , m i x N / A

c r o s s f e e d o n , o N / A

c r o s s f e e d d i r e c t g a i n 0 t o 6 0 0 . 1 d B

c r o s s f e e d c r o s s g a i n 3 0 t o 1 2 0 0 . 1 d B

c r o s s f e e d h f a t t e n u a t i o n 6 0 t o 2 4 0 0 . 1 d B

c r o s s f e e d h f c u t o 5 0 0 t o 2 0 0 0 H z

e q e n a b l e d o n , o N / A

e q p r e c u t 0 t o 2 4 0 0 . 1 d B

e q b a n d 0 c u t o 0 t o 3 2 7 6 8 H z






e q b a n d 1 c u t o 0 t o 3 2 7 6 8 H z

e q b a n d 2 c u t o 0 t o 3 2 7 6 8 H z

e q b a n d 3 c u t o 0 t o 3 2 7 6 8 H z

e q b a n d 4 c u t o 0 t o 3 2 7 6 8 H z

e q b a n d 0 q 0 t o 6 4 N / A

e q b a n d 1 q 0 t o 6 4 N / A

e q b a n d 2 q 0 t o 6 4 N / A

e q b a n d 3 q 0 t o 6 4 N / A

e q b a n d 4 q 0 t o 6 4 N / A

e q b a n d 0 g a i n - 2 4 0 t o 2 4 0 0 . 1 d B

e q b a n d 1 g a i n - 2 4 0 t o 2 4 0 0 . 1 d B

e q b a n d 2 g a i n - 2 4 0 t o 2 4 0 0 . 1 d B

e q b a n d 3 g a i n - 2 4 0 t o 2 4 0 0 . 1 d B

e q b a n d 4 g a i n - 2 4 0 t o 2 4 0 0 . 1 d B

d i t h e r i n g e n a b l e d o n , o N / A

t i m e s t r e t c h e n a b l e d o n , o N / A

c o m p r e s s o r t h r e s h o l d 0 t o - 2 4 - 3 d B

c o m p r e s s o r m a k e u p g a i n o , a u t o N / A

c o m p r e s s o r r a t i o 2 : 1 , 4 : 1 , 6 : 1 , 1 0 : 1 , l i m i t N / A

c o m p r e s s o r k n e e h a r d k n e e , s o f t k n e e N / A

c o m p r e s s o r r e l e a s e t i m e 1 0 0 t o 1 0 0 0 1 0 0 m s

b e e p o , w e a k , m o d e r a t e , s t r o n g N / A

k e y c l i c k o , w e a k , m o d e r a t e , s t r o n g N / A

k e y c l i c k r e p e a t s o n , o N / A

d i r c a c h e o n , o N / A

t a g c a c h e _ r a m o n , o N / A

p e a k m e t e r r e l e a s e 1 t o 1 2 6 ?

p e a k m e t e r h o l d o , 2 0 0 m s , 3 0 0 m s , 5 0 0 m s , 1 , 2 , 3 ,

4 , 5 , 6 , 7 , 8 , 9 , 1 0 , 1 5 , 2 0 , 3 0 , 1 m i n

N / A

p e a k m e t e r c l i p h o l d o n , 1 , 2 , 3 , 4 , 5 , 6 , 7 , 8 , 9 , 1 0 , 1 5 ,

2 0 , 2 5 , 3 0 , 4 5 , 6 0 , 9 0 , 2 m i n , 3 m i n ,

5 m i n , 1 0 m i n , 2 0 m i n , 4 5 m i n , 9 0 m i n

N / A

p e a k m e t e r b u s y o n , o N / A

p e a k m e t e r d b f s o n , o o n : d b f s , o : l i n -

e a r

p e a k m e t e r m i n 0 t o 8 9 ( d B ) o r 0 t o 1 0 0 ( % ) d B o r %

p e a k m e t e r m a x 0 t o 8 9 / ( d B ) o r 0 t o 1 0 0 ( % ) d B o r %

s t a t u s b a r o , t o p , b o t t o m N / A

s c r o l l b a r o , l e f t , r i g h t N / A

s c r o l l b a r w i d t h 3 t o L C D w i d t h / 1 0 ( d e v i s e a

w a y t o g e t r a n g e s f r o m

c o n g - * . h )

p i x e l s






v o l u m e d i s p l a y g r a p h i c , n u m e r i c N / A

b a t t e r y d i s p l a y g r a p h i c , n u m e r i c N / A

f o n t / p a t h / l e n a m e . f n t N / A

k b d / p a t h / l e n a m e . k b d N / A

i p d i s p l a y o n , o N / A

s e l e c t o r t y p e p o i n t e r , b a r ( i n v e r s e ) , b a r ( c o l o r ) ,

b a r ( g r a d i e n t )

N / A

s h o w i c o n s o n , o N / A

i c o n s e t / p a t h / l e n a m e . b m p N / A

v i e w e r s i c o n s e t / p a t h / l e n a m e . b m p N / A

b a c k d r o p / p a t h / l e n a m e . b m p N / A

f o r e g r o u n d c o l o u r 0 0 0 0 0 0 t o F F F F F F R R G G B B

b a c k g r o u n d c o l o u r 0 0 0 0 0 0 t o F F F F F F R R G G B B

l i n e s e l e c t o r s t a r t c o l o u r 0 0 0 0 0 0 t o F F F F F F R R G G B B

l i n e s e l e c t o r e n d c o l o u r 0 0 0 0 0 0 t o F F F F F F R R G G B B

l i n e s e l e c t o r t e x t c o l o u r 0 0 0 0 0 0 t o F F F F F F R R G G B B

l e t y p e c o l o u r s / p a t h / l e n a m e . c o l o u r s N / A

t i m e f o r m a t 1 2 h o u r , 2 4 h o u r N / A




A p p e n d i x D . M e n u O v e r v i e w 2 0 4

D . M e n u O v e r v i e w

i n c l u d e a n o v e r v i e w o f t h e m e n u s t r u c t u r e h e r e




A p p e n d i x E . U s e r f e e d b a c k 2 0 5

E . U s e r f e e d b a c k

E . 1 . B u g r e p o r t s

I f y o u e x p e r i e n c e i n a p p r o p r i a t e p e r f o r m a n c e f r o m a n y s u p p o r t e d f e a t u r e , p l e a s e l e a

b u g r e p o r t o n o u r w e b p a g e . D o n o t r e p o r t m i s s i n g f e a t u r e s a s b u g s , i n s t e a d l e t h e m

a s f e a t u r e i d e a s ( s e e b e l o w ) .

F o r o p e n b u g r e p o r t s r e f e r t o h t t p : / / w w w . r o c k b o x . o r g / t r a c k e r / i n d e x . p h p ? t y p e = 2

E . 1 . 1 . R u l e s f o r s u b m i t t i n g n e w b u g r e p o r t s

1 . C h e c k t h a t t h e b u g h a s n o t a l r e a d y b e e n r e p o r t e d

2 . A l w a y s i n c l u d e t h e f o l l o w i n g i n f o r m a t i o n i n y o u r b u g r e p o r t :

• W h i c h e x a c t p l a y e r y o u h a v e .

• W h i c h e x a c t R o c k b o x v e r s i o n y o u a r e u s i n g ( M e n u → S y s t e m → R o c k b o x

I n f o → V e r s i o n )

• A s t e p - b y - s t e p d e s c r i p t i o n o f w h a t y o u d i d a n d w h a t h a p p e n e d

• W h e t h e r t h e p r o b l e m i s r e p e a t a b l e o r a o n e - t i m e o c c u r r e n c e

• A l l r e l e v a n t d a t a r e g a r d i n g t h e p r o b l e m , s u c h a s p l a y l i s t s , M P 3 l e s e t c . ( I M -

P O R T A N T ! )

E . 2 . F e a t u r e i d e a s

T o s u g g e s t a n i d e a f o r a f e a t u r e o r t o r e a d t h o s e m a d e b y o t h e r s , s e e h t t p : / / f o r u m s .

r o c k b o x . o r g / i n d e x . p h p ? b o a r d = 4 9 . 0 . P l e a s e k e e p i n m i n d t h a t t h i s f o r u m i s f o r t h e d i s c u s -

s i o n o f f e a t u r e i d e a s - t h e y a r e n o t r e q u e s t s a n d t h e r e i s n o g u a r a n t e e t h e y w i l l b e a c t e d

u p o n .

E . 2 . 1 . R u l e s f o r s u b m i t t i n g a n e w f e a t u r e i d e a

1 . C h e c k t h a t t h e f e a t u r e h a s n o t a l r e a d y b e e n s u g g e s t e d . D u p l i c a t e s a r e r e a l l y b o r i n g !

2 . C h e c k t h a t t h e f e a t u r e h a s n o t a l r e a d y b e e n i m p l e m e n t e d . D o w n l o a d t h e l a t e s t

c u r r e n t / d a i l y b u i l d a n d / o r s e a r c h t h e m a i l l i s t a r c h i v e .

3 . C h e c k t h a t t h e f e a t u r e i s p o s s i b l e t o i m p l e m e n t ( s e e s e c t i o n E . 2 . 2 ( p a g e 2 0 6 ) ) .


http://forums.rockbox.org/index.php?board=49.0

http://forums.rockbox.org/index.php?board=49.0

http://www.rockbox.org/tracker/index.php?type=2



A p p e n d i x E . U s e r f e e d b a c k 2 0 6

E . 2 . 2 . F e a t u r e s w e w i l l n o t i m p l e m e n t

T h i s i s a l i s t o f F e a t u r e R e q u e s t s w e g e t r e p e a t e d l y t h a t w e s i m p l y c a n n o t d o . V i e w i t

a s t h e o p p o s i t e o f a T O D O !

• I n t e r f a c i n g w i t h o t h e r U S B d e v i c e s ( l i k e c a m e r a s ) o r 2 p l a y e r g a m e s o v e r U S B .

T h e U S B s y s t e m d e m a n d s t h a t t h e r e i s a m a s t e r t h a t t a l k s t o a s l a v e . T h e p l a y e r

c a n o n l y s e r v e a s a s l a v e , a s m o s t o t h e r U S B d e v i c e s s u c h a s c a m e r a s c a n . T h u s ,

w i t h o u t a m a s t e r n o c o m m u n i c a t i o n b e t w e e n t h e s l a v e s c a n t a k e p l a c e . I f t h a t i s

n o t e n o u g h , w e h a v e n o w a y o f a c t u a l l y c o n t r o l l i n g t h e c o m m u n i c a t i o n p e r f o r m e d

o v e r U S B s i n c e t h e U S B c i r c u i t i n t h e p l a y e r i s s t r i c t l y m a d e f o r d i s k - a c c e s s a n d

d o e s n o t a l l o w u s t o p l a y w i t h i t t h e w a y w e ' d n e e d f o r a n y g o o d c o m m u n i c a t i o n

t o w o r k .

• S u p p o r t o t h e r l e s y s t e m s t h a n F A T 3 2 ( l i k e N T F S o r e x t 2 e t c . ) .

N o . s u p p o r t f o r m o r e l e s y s t e m s w i l l j u s t t a k e a w a y v a l u a b l e r a m f o r u n n e c e s s a r y

f e a t u r e s . Y o u c a n p a r t i t i o n y o u r p l a y e r n e , j u s t m a k e s u r e t h e r s t o n e i s F A T 3 2

a n d t h e n m a k e t h e o t h e r o n e s w h a t e v e r l e s y s t e m y o u w a n t . J u s t d o n o t e x p e c t

R o c k b o x t o u n d e r s t a n d t h e m .

• A d d s c a n d i s k - l i k e f e a t u r e s .

I t w o u l d b e a v e r y s l o w o p e r a t i o n t h a t w o u l d d r a i n t h e b a t t e r i e s a n d t a k e a l o t o f

u s e f u l r a m f o r s o m e t h i n g t h a t i s m u c h b e t t e r a n d f a s t e r d o n e w h e n c o n n e c t e d t o a

h o s t c o m p u t e r .

• A l p h a b e t i c a l l i s t s k i p p i n g .

S k i p p i n g a r o u n d t h e l i s t s b y j u m p i n g l e t t e r s ( i . e s k i p a l l C ' s a n d g o s t r a i g h t t o t h e

r s t D ) . T h i s i s n ' t f e a s i b l e w i t h t h e c u r r e n t l i s t i m p l e m e n t a t i o n , i f y o u r e a l l y w a n t

t h i s y o u c a n g e t s i m i l a r e e c t s u s i n g t h e d a t a b a s e ( s e e s e c t i o n 4 . 2 ( p a g e 2 7 ) ) .

• A d d s u p p o r t f o r n o n s t a n d a r d t a g f o r m a t s .

A P E t a g s i n M P 3 l e s h a s b e e n r e j e c t e d a f e w t i m e s a l r e a d y . I t s n o t s o m e t h i n g w e

w a n t .

• I m p l e m e n t i n g t h e a b i l i t y t o p l a y b a c k D R M l e s .

F i r s t l y , t h i s w o u l d b e e x t r e m e l y d i c u l t t o i m p l e m e n t l e g a l l y - R o c k b o x i s n o t

l e g a l e n t i t y a s s u c h , a n d t h e r e f o r e i s u n a b l e t o e n t e r i n t o l i c e n s e a g r e e m e n t s w i t h

p r o v i d e r s o f D R M t e c h n o l o g y . S e c o n d l y , R o c k b o x i s o p e n s o u r c e , w h i c h w o u l d m e a n

t h a t a n y D R M t e c h n o l o g y w e i n c o r p o r a t e d i n t o o u r c o d e b a s e w o u l d s u d d e n l y b e -

c o m e v i s i b l e t o t h e w h o l e w o r l d , c o m p l e t e l y d e f e a t i n g i t s p u r p o s e . R e m e m b e r ,

D R M a c h i e v e s p a r t o f i t ' s s e c u r i t y t h r o u g h o b s c u r i t y , a n d p u b l i s h i n g t h e k e y s n e c -

e s s a r y t o d e c r y p t D R M ' d m e d i a w o u l d e s s e n t i a l l y r e n d e r i t u s e l e s s .




A p p e n d i x F . C r e d i t s 2 0 7

F . C r e d i t s

P e o p l e t h a t h a v e c o n t r i b u t e d t o t h e p r o j e c t , o n e w a y o r a n o t h e r . F r i e n d s !

· B j ö r n S t e n b e r g · L i n u s N i e l s e n F e l t z -

i n g · A n d y C h o i · A n d r e w J a m i e s o n

· P a u l S u a d e · J o a c h i m S c h i f f e r

· D a n i e l S t e n b e r g · A l a n K o r r · G a r y

C z v i t k o v i c z · S t u a r t M a r t i n · F e -

l i x A r e n d s · U l f R a l b e r g · D a v i d

H ä r d e m a n · T h o m a s S a e y s · G r a n t

W i e r · J u l i e n L a b r u y é r e · N i c o l a s

S a u z e d e · R o b e r t H a k · D a v e C h a p -

m a n · S t e f a n M e y e r · E r i c L i n e n b e r g

· T o m C v i t a n · M a g n u s Ö m a n · J e r o m e

K u p t z · J u l i e n B o i s s i n o t · N u u t t i K o -

t i v u o r i · H e i k k i H a n n i k a i n e n · H a r d -

e e p S i d h u · M a r k u s B r a u n · J u s t i n

H e i n e r · M a g n u s H o l m g r e n · B i l l

N a p i e r · G e o r g e S t y l e s · M a t s L i d e l l

· L e e M a r l o w · N a t e N y s t r o m · N i c k

R o b i n s o n · C h a d L o c k w o o d · J o h n

P y b u s · U w e F r e e s e · R a n d y W o o d

· G r e g o r y H a e r r · P h i l i p p P e r t e r -

m a n n · G i l l e s R o u x · M a r k H i l l e b r a n d

· D a m i e n T e n e y · A n d r e a s Z w i r t e s

· K j e l l E r i c s o n · J i m H a g a n i · L u -

d o v i c L a n g e · M i k e H o l d e n · S i m o n

E l é n · M a t t h e w P . O R e i l l y · C h r i s t i a n

S c h ö n b e r g e r · H e n r i k B a c k e · C r a i g

S a t h e r · J o s é M a r i a G a r c i a - V a l d e c a s a s

B e r n a l · S t e v i e O h · J ö r g H o h e n s o h n

·D a v e J o n e s

·T h o m a s P a u l D i f f e n -

b a c h · R o l a n d K l e t z i n g · I t a i S h a k e d

· K e i t h H u b b a r d · B e n j a m i n M e t z l e r

· F r e d e r i c D a n g N g o c · P i e r r e D e -

l o r e · H u w S m i t h · G a r r e t t D e r n e r

· B a r r y M c I n t o s h · L e s l i e D o n a l d -

s o n · L e e P i l g r i m · Z a k k R o b e r t s

· F r a n c o i s B o u c h e r · M a t t h i a s W i e n -

t a p p e r · B r e n t C o u t t s · J e n s A r n o l d

· G e r a l d V a n b a r e n · C h r i s t i S c a r b o r -

o u g h · S t e v e C u n d a r i · M a t H o l t o n

· J a n G a j d o s · A n t o i n e C e l l e r i e r

· B r i a n K i n g · J i r i J u r e c e k · J a c o b E r l -

b e c k · J e a n - P h i l i p p e B e r n a r d y · D a v e

H o o p e r · J o n a s H ä g g q v i s t · T h o m

J o h a n s e n · R i n a t Z a k i r o v · M a n u e l

D e j o n g h e · M a r c o e n H i r s c h b e r g

· M i c h i e l v a n d e r K o l k · T o n y M o t a k i s

· A n d y Y o u n g · A l e x a n d r e B o u r g e t

· R i c h a r d S . L a C h a r i t é I I I · C h r i s -

t i a n G m e i n e r · T o m a s S a l f i s c h b e r g e r

· M i i k a P e k k a r i n e n · T a p i o K a r p p i n e n

· R i c h a r d O t t ó O ' B r i e n · L u c a B u -

r e l l i · A l e s s i o L e n z i · D a v i d B r y a n t

· M a r t i n A r v e r · A l e x a n d e r S p y r i d a k i s

· P e d r o B a l t a z a r V a s c o n c e l o s · R a y

L a m b e r t · D a v e W i a r d · P i e t e r B o s

· K o n s t a n t i n I s a k o v · B r y a n V a n d y k e

· H r i s t o K o v a c h e v · S a n d e r S w e e r s

· A n t o n i u s H e l l m a n · R y a n J a c k s o n

· P e r H o l m ä n g · F r e d e r i c D e v e r n a y

· J o s é M . F a n d i ñ o · G a d i C o h e n · N a f -

t a l i G o l d s t e i n · D a v i d D e n t · F r a n k

D i s c h n e r · L i b e r m a n S h a c h a r · S t e p h a n

W e z e l · A l y s s a M i l b u r n · K e v i n F e r -

r a r e

·A n t o n O l e y n i k o v

·M a r k A r i g o

· M a g n u s W e s t e r l u n d · J a k e O w e n

· M u s t a p h a S e n h a j i · A d a m B o o t

· J o n a t h a n G o r d o n · T a t T a n g · T o s h i -

h i k o I t o h · D a v i d J . S o n g · J e o n g T a e k

I n · A n d e r s K a g e r i n · P e t e r D ' H o y e

· B e n B a s h a · B r a n d o n L o w · N a t h a n





H a n d · N i c k L a n h a m · S e b a s t i a n H e n -

r i k s e n · M a r t i n S c a r r a t t · K a r l

K u r b j u n · T o m a s z M a l e s i n s k i · A n -

d r e w P i l l e y · M a t t v . d . W e s t h u i z e n

·T i m C r i s t

·J v o S t u d e r

·D a n E v e r -

t o n · I m r e H e r c e g · S e v e n L e M e s l e

· C r a i g B a c h e l o r · N i k o l a j C h r i s -

t e n s e n · M i k a e l M a g n u s s o n · D o m i n i k

W e n g e r · H e n r i c o W i t v l i e t · A n d r e w

S c o t t · M i g u e l A . A r é v a l o · A a r o n

F . G o n z a l e z · A l e k s e y K o z y u l i n · J a n i

K i n n u n e n · R u i M a r i n h o · A l u n T h o m a s

· N i l s W a l l m é n i u s · N a o a k i O k a z a k i

· W i l l D y s o n · M a t t h i a s M o h r · C h r i s -

t i a n M a r g · E l i S h e r e r · F r e d r i k

Ö h r n

·N i c o l a s P e n n e q u i n

·R a l f H e r z

· M i c h a e l D i F e b b o · D a v i d R o t h e n -

b e r g e r · R o b e r t K e e v i l · M a r k B r i g h t

· D o m i n i k R i e b e l i n g · A l e x a n d e r B o n -

d a r · P e t e r C a w l e y · R a n i H o d · T o m

R o s s · A n t o n R o m a n o v · J e a n - L u c

O h l · S t e v e B a v i n · M a r i a n n e A r n o l d

· G a e t a n o V o c c a · F r e d e r i k V e s t r e

· W e n b i n L e o · T o m E v a n s · E w a n

D a v i e s · F r é d é r i c F r a n ç o i s · M a r c -

A n d r é M o r e a u · I o a n n i s K o u t o u l a k i s

·A l i s t a i r M a r s h a l l

·K a r l O v e

H u f t h a m m e r · V í c t o r Z a b a l z a · U l r i c h

P e g e l o w · A n d r e a s M a t t s s o n · D a n i e l

A n k e r s · P a u l L o u d e n · R a i n e r S i n -

s c h · P l á c i d o R e v i l l a · M i c h a e l S e -

v a k i s · L u k a s S a b o t a · E m a n u e l Z e p h i r

· A l e x a n d e r L e v i n · B a r r y W a r d e l l

· L a r s v a n d e K l o m p · P h i l i p p e M i o s s e c

· J o c h e n K e m n a d e · C o r r y L a z a r o w i t z

· T o m M e y e r · L a u r e n t B a u m · J a m e s

T e h · L i a m N a t t r a s s · C h r i s t i a n

H a c k

·W a d e B r o w n

·V a d i m C h e k a n

· C h r i s t o p h e r B o r c s o k · V i c t o r C a r d e -

n a s · A n d r e w M e l v i l l e · P e n g x u a n L i u

· A n d r e w C u p p e r · T h i l o - A l e x a n d e r

G i n k e l · A d a m G a s h l i n · R o b e r t K u k l a

· D a v i d Q u e s a d a · J a r e d S t a f f o r d

· M a r t i n H e n s e l · S t é p h a n e D o y o n

· A u s t i n A p p e l · A n d r e S m i t h · T r a v i s

H y y p p a · I a n W e b b e r · P a v e l G n e l i t s a

· L u t z B ö h n e · W i l l R o b e r t s o n

· R o b e r t C a r b o n e a u · Y e W e i · B r y a n

C h i l d s

·M i k e S c h m i t t

·C h r i s T a y l o r

· T o b i a s L a n g h o f f · S t e v e G o t t h a r d t

· G r e g W h i t e · M a t t i e u F a v r é a u x

· M a l c o l m T y r r e l l · P i o t r J a f i s -

z o w · G a r y A l l e n · J o h n B o u A n t o u n

· T o m a s z M o n · J a k u b M a t o u ² e k · A l -

b e r t V e l i · C h r i s D o h a n · T a k a s h i

O b a r a · R e n e P e i n t h o r · R o a n H o r n i n g

· B e n K e r o a c k · S e a n M o r r i s e y · S h a y

G r e e n · N i c k V a n d e r w e i t · S i m o n M e n -

z e l · T i m o H o r s t s c h ä f e r · J a c c o K o n -

i n g

·C h r i s H a m

·J o s e R a m o n G a r -

c i a · S i m o n D e s c a r p e n t r i e s · D o u g l a s

V a l e n t i n e · J a c o b G a r d n e r · P a s c a l

B r i e h l · D e n i s S t a n i s h e v s k i y · E d d y

C o m a n · L u k e B l a n e y · M a r k R e i c h e

· M i c h a l J e v j a k · P h i l i p p e L a t u l i p p e

· M a u r i c i o P e c c o r i n i · N a t h a n H e p t i n g

· A k i o I d e h a r a · D a g n i M c P h e e · A l e x

G e r c h a n o v s k y · G e r h a r d D i r s c h l · I v a n

Z u p a n · A l e x a n d e r P a p s t · C h r i s t o p h

R e i t e r · R h i n o B a n g a · P a u l J o n e s

·M i c h a e l G i a c o m e l l i

·A l e x W e n g e r

· A n d r e e B u s c h m a n n · J o h n a t h o n M i -

h a l o p · R e n e A l l k i v i · T o b i a s S c h l a d t

· J o h n Z h o u · C h a r l e s V o e l g e r · G e r -

r i t t G o n z a l e s · D i e t e r P e l l k o f e r

· E v g e n i y K a c h a l i n · L e n n y K o e p s e l l

· H a r r y T u · P a w e l W y s o c k i · X i n l u

H u a n g · D a n i e l D a l t o n · B o r i s G j e n -

e r o · S y l v a i n F o u r m a n o i t · A l e x

P a r k e r · M a r i o L a n g · J u s t i n F o e l l

· I g o r K u z m i n · A d i l s o n V i c e n t e X a v i e r

·J e s s e L o c k w o o d

·J o n a t h a n B a c k e r

· S o f i a n B a b a i · C o s t a s C a l a m v o k i s

· C a t a l i n P a t u l e a · P e t e r H a r l e y

· M a x K e l l e y · A l e x a n d e r E i c k -

h o f f · K e n F a z z o n e · D a v i d B i s h o p

· H e i n - P i e t e r v a n B r a a m · P r z e m y s ª a w

H o ª u b o w s k i · S t e p a n M o s k o v c h e n k o





· J o h n S . G w y n n e · B r i a n J . M o r e y

· S t i j n H i s k e n · B e r t r i k S i k k e n · K a r i m

B o u c h e r · J a m e s E s p i n o z a · F r a n z

R ü h m l a n d · J o r d a n A n d e r s o n · M a u r u s

C u e l e n a e r e

·C h r i s A l l e g r e t t a

·A l a s -

t a i r S · M a r t i n C r k o v s k ý · A r i y a H i -

d a y a t · J o n a s H u r r e l m a n n · L e e K a n g

H y u k · C l e m e n s W e r t h e r · R o b e r t

M e n e s · H e n r i V a l t a · M e l b a S i t j a r

· M e h m e t � . Ç a t a l b a ³ · S c o t t T i n -

m a n · A l e x a n d e r K u z m e n k o v · T h o m a s

M a r t i t z · P r a k a r n S a h a s o o n t o r n -

v u t e · G e o r g e T a m p l a r u · A p o o r v a

M a h a j a n · V u o n g M i n h H i e p · M a -

t e u s z K u b i c a · F r a n k G e v a e r t s · C h -

e l o S a c r i s t á n

·S a s c h a W o l f

·N i c k -

o l a y J o r d a n o v · J o h a n n e s V o g g e n -

t h a l e r · M a r c G u a y · A l e x V a n d e r -

p o l · J e r r y L a n g e · Y o h a n n M i s q u i t t a

· K e i t h P e r r i · M a r k F a w c u s · I v a n

P e s i c · M a r c e l B a r b u l e s c u · P h i l L i g h t

· R o b P u r c h a s e · A n d r e a s M ü l l e r

· C h r i s t o p h e r W i l l i a m s · M a r t i n R i t -

t e r · J u s t i n H a n n i g a n · T o m a s z W a s i l -

c z y k · K e n j i r o A r a i · J o h n K a m i n a r

· J o r i s G o o s e n · M a r k G a n s o n · D a -

v i d e G e n t i l e

·J a m e s V a s i l e

·M o -

h a m e d T a r e k · M i k e B u r k e · M i c h a e l

C h i c o i n e · M a c i e j A d a m c z a k · T o m e r

S h a l e v · T h i b a u t G i r k a · R a s m u s R y

· W i l l i a m P o e t r a Y o g a H a d i s o e s e n o

· A d r i a n O s o i a n u · M a r t i n P a h l · O r i

A v t a l i o n · T h o m a s S c h o t t · D e n n i s

I v a n o v · T a k u m i S u z u k i · S h u n s u k e

S h i m i z u · T a d a y u k i N i s h i z o n o · J u n

G u · D a n i e l W e c k · C l é m e n t P i t -

C l a u d e l · J e l l e G e e r t s · T a d e u s z P y ±

·R o s t i s l a v C h e k a n

·F l o r i n P o p e s c u

· V o l k e r M i s c h e · V i t j a M a k a r o v

· F r a n c i s c o V i l a · C h r i s t i a n L e e s

· R a f a ë l C a r r é · D e n e s B a l a t o n i · R o y

W a l l a c e · E r i c L a s s a u g e · F r a n ç o i s

D i n e l · F r a n c e s c o R i g o n i · J o ë l P u i k

· K l a a s B o s t e e l s · T e r u a k i K a w a s h i m a

· M a r c i n � u k a s i k · L e J i n · A l e x B e n -

n e e · S t é p h a n e Q u e r t i n m o n t · B a r t o s z

F a b i a n o w s k i · A d a m H o g a n · A n d r e w

M a h o n e · A n t o n V e r e t e n e n k o · V i -

c e n t e I b a r r a

·R u i A r a ú j o

·B r i a n

C l o u t i e r · O l i v i e r B a r b u t · Y o s h i -

h i s a U c h i d a · S a n g g o n L e e · K a s p a r

R o t h e n f u ÿ e r · R y a n P r e s s · C r a i g E l -

l i o t t · K e n d e r e s T a m a s · E r i c S h a t -

t o w · J o s h u a S i m m o n s · S e i A o y u m i

· M a r t i n P o o l · G a r e t h S c h a k e l

· B r i a n S u t h e r l a n d · S a m B o u w e r · J o -

h a n n e s L i n k e · M i c h a ë l B u r t i n · S a s h a

K h a m k o v · K a i P o s a d o w s k y · J a c k

H a l p i n · J o h a n n e s S c h w a r z · D u s t i n

S k o r a c k i

·T o r n e W u f f

·W o o k e y

· N i c k S a n t · M i c h a e l C a r r · E r i c

C l a y t o n · M a r k o P a h l k e · V y t e n i s

S a b e l k a · N i c o l a s P i t r e · B e n e d i k t

G o o s · F r e d e r i c k F u l l · J e f f r e y G o o d e

· R a a f a t A k k a d · D a v i d e Q u a r t a · A n -

d r e L u p a · H i l t o n S h u m w a y · M a t t h e w

B o n n e t t · N i c k T r y o n · D a v i d J o h n s t o n

· R a l p h S o t o · M y k h a i l o R a d z i e v s k y i

· C h r i s t o p h e G o u i r a n · A s a e l R e -

i t e r · J e n s E r d m a n n · R o s s o M a l t e s e

·A m a u r y P o u l y

·L a u r e n t P a p i e r

·J o -

h a n n e s B o y · J a s o n Y u · A a r o n D e -

M i l l e · T o m a s z K o w a l c z y k · M i c h a e l

L e c h n e r · P e t e r S c h l e n k e r · D a n

D a v i s o n · D a v i d K a u f f m a n n · C a r s t e n

S c h r e i t e r · M i c h a e l S p a r m a n n · S e t h

O p g e n o r t h · J o n a s A a b e r g · J u n i o C

H a m a n o · B o b C o u s i n s · C h r i s t o p h e

N i c o l a s · Y a n n M u l l e r · S a s c h a W i l d e

· F r e d B a u e r · S i m o n R o t h e n · P a v e l

R z e h á k · D i e g o H e r r a n z · V i k t o r

V a r g a

·J u l i u s z C h r o b o c z e k

·C h r i s -

t i a n B e i e r · G i o v a n n i Z i l l i · S h i l o h

H a w l e y · P e t e r L e c k ý · W i l f r e d

H u g h e s · L a u r e n t G a u t i e r · S i m o n

Z h u k o v s k y · D a n i e l K l u z · P h i n i t -

n u n C h a n a s a b a e n g · T s e - H s i e n C h i a n g

· S z y m o n D z i o k · D o m e n i c o D i M i s a





· D e l y a n K r a t u n o v · P u r l i n g N a y u k i

· M a r e k S a l a b a · A l t a y O z · M a r k

B o r g e r d i n g · T o b i a s D i e d r i c h · A n d r e w

E n g e l b r e c h t · K e v i n S c h o e d e l · J e n s

T h e e ÿ

·A l e x e y N e m t s e v

·P a s c a l B e -

l o w · D a n n y A t t a r · P h i l i p p S t e p h a n i

· T o r e J o h n n y B r å t v e i t · M a r c i n

B u k a t · A n d r e w R o d l a n d · L u c a

L e o n a r d o S c o r c i a · G e r h a r d Z i n t e l

· A d r i á n C e r e t o M a s s a g u é · C h r i s S a v -

e r y · R a p h a ë l J a k s e · W i n c e n t B a l i n

· A a r o n R o t h b a u m · N e j c L o t r i c · H i n -

r i k Ö r n S i g u r ð s s o n · S t e p h e n C a r r o l l

· J o e B a l o u g h · J é r ô m e H e i l · T i m

G r a f · M a r t i n S ä g m ü l l e r · J o s h u a

H u l s t

·P i e r r e - Y v e s R o o s e n s

·H a y d e n

P e a r c e · R o d r i g o B a r r e t t o · D a n i e l

R i g b y · A l e x e y P o l k h i r e v · I s t v á n

N a g y · W o j c i e c h L e s n i a k · T u o m a s

A i r a k s i n e n · C a l v i n W a l d e n · M i c h a e l

G e n t r y · D a v i d F o w l e · F a b i a n V o g e l

· M i c h a e l S t u m m v o l l · F r a n z - J o s e f

H a i d e r · M i c h a e l H o h m u t h · S e r g i o

V e r a · M i c h a e l L e s l i e · C r a i g M a n n

· W i l l i a m P e t e r s · L i J i e · C r i s t i n a

T a l p i g a · A l e x a n d e r M e s h c h e r y a k o v

· R y a n S a w h i l l · T h o m a s J a r o s c h · W i l l

S o w e r b u t t s

·G a b r i e l M a i a

·R o b e r t

H o r n · A n t e M a r e t i c · B e n j a m i n B r o w n

· U w e W i e b a c h · T h e l i b m a d t e a m

· T h e w a v p a c k t e a m · T h e F F m p e g t e a m

· T h e O g g V o r b i s t e a m · T h e l i b a 5 2

t e a m · T h e S p e e x t e a m · T h e l i b f a a d

t e a m · T h e D o o m t e a m · T h e g n u c h e s s

t e a m · T h e g n u b o y t e a m · T h e P a c m a n

I n s t r u c t i o n a l E m u l a t o r t e a m · T h e

S p e c t e m u t e a m · T h e l i b m p e g 2 t e a m

· T h e G a m e _ M u s i c _ E m u t e a m · T h e

O p e n S P C D S P e m u l a t o r t e a m

·T h e

A L A C d e c o d e r t e a m · T h e U C L t e a m

· T h e i P o d L i n u x t e a m · T h e V i s i o n - 8

E m u l a t o r t e a m · T h e r o b o t f i n d s k i t -

t e n t e a m · T h e l i b m t p t e a m · T h e a s a p

t e a m · T h e l i b p n g t e a m · T h e P u r e

D a t a t e a m ( M i l l e r P u c k e t t e a n d o t h -

e r s ) · T h e M i k M o d t e a m




A p p e n d i x G . L i c e n s e s 2 1 1

G . L i c e n s e s

G . 1 . G N U F r e e D o c u m e n t a t i o n L i c e n s e

V e r s i o n 1 . 2 , N o v e m b e r 2 0 0 2

C o p y r i g h t

c 2 0 0 0 , 2 0 0 1 , 2 0 0 2 F r e e S o f t w a r e F o u n d a t i o n , I n c .

5 1 F r a n k l i n S t , F i f t h F l o o r , B o s t o n , M A 0 2 1 1 0 - 1 3 0 1 U S A

E v e r y o n e i s p e r m i t t e d t o c o p y a n d d i s t r i b u t e v e r b a t i m c o p i e s o f t h i s l i c e n s e d o c u m e n t ,

b u t c h a n g i n g i t i s n o t a l l o w e d .

P r e a m b l e

T h e p u r p o s e o f t h i s L i c e n s e i s t o m a k e a m a n u a l , t e x t b o o k , o r o t h e r f u n c t i o n a l a n d u s e f u l

d o c u m e n t f r e e i n t h e s e n s e o f f r e e d o m : t o a s s u r e e v e r y o n e t h e e e c t i v e f r e e d o m t o c o p y

a n d r e d i s t r i b u t e i t , w i t h o r w i t h o u t m o d i f y i n g i t , e i t h e r c o m m e r c i a l l y o r n o n c o m m e r c i a l l y .

S e c o n d a r i l y , t h i s L i c e n s e p r e s e r v e s f o r t h e a u t h o r a n d p u b l i s h e r a w a y t o g e t c r e d i t f o r

t h e i r w o r k , w h i l e n o t b e i n g c o n s i d e r e d r e s p o n s i b l e f o r m o d i c a t i o n s m a d e b y o t h e r s .

T h i s L i c e n s e i s a k i n d o f c o p y l e f t , w h i c h m e a n s t h a t d e r i v a t i v e w o r k s o f t h e d o c u m e n t

m u s t t h e m s e l v e s b e f r e e i n t h e s a m e s e n s e . I t c o m p l e m e n t s t h e G N U G e n e r a l P u b l i c

L i c e n s e , w h i c h i s a c o p y l e f t l i c e n s e d e s i g n e d f o r f r e e s o f t w a r e .

W e h a v e d e s i g n e d t h i s L i c e n s e i n o r d e r t o u s e i t f o r m a n u a l s f o r f r e e s o f t w a r e , b e -

c a u s e f r e e s o f t w a r e n e e d s f r e e d o c u m e n t a t i o n : a f r e e p r o g r a m s h o u l d c o m e w i t h m a n u a l s

p r o v i d i n g t h e s a m e f r e e d o m s t h a t t h e s o f t w a r e d o e s . B u t t h i s L i c e n s e i s n o t l i m i t e d t o

s o f t w a r e m a n u a l s ; i t c a n b e u s e d f o r a n y t e x t u a l w o r k , r e g a r d l e s s o f s u b j e c t m a t t e r o r

w h e t h e r i t i s p u b l i s h e d a s a p r i n t e d b o o k . W e r e c o m m e n d t h i s L i c e n s e p r i n c i p a l l y f o r

w o r k s w h o s e p u r p o s e i s i n s t r u c t i o n o r r e f e r e n c e .

1 . A P P L I C A B I L I T Y A N D D E F I N I T I O N S

T h i s L i c e n s e a p p l i e s t o a n y m a n u a l o r o t h e r w o r k , i n a n y m e d i u m , t h a t c o n t a i n s a

n o t i c e p l a c e d b y t h e c o p y r i g h t h o l d e r s a y i n g i t c a n b e d i s t r i b u t e d u n d e r t h e t e r m s o f t h i s

L i c e n s e . S u c h a n o t i c e g r a n t s a w o r l d - w i d e , r o y a l t y - f r e e l i c e n s e , u n l i m i t e d i n d u r a t i o n ,

t o u s e t h a t w o r k u n d e r t h e c o n d i t i o n s s t a t e d h e r e i n . T h e D o c u m e n t , b e l o w , r e f e r s

t o a n y s u c h m a n u a l o r w o r k . A n y m e m b e r o f t h e p u b l i c i s a l i c e n s e e , a n d i s a d d r e s s e d

a s y o u . Y o u a c c e p t t h e l i c e n s e i f y o u c o p y , m o d i f y o r d i s t r i b u t e t h e w o r k i n a w a y

r e q u i r i n g p e r m i s s i o n u n d e r c o p y r i g h t l a w .





A M o d i e d V e r s i o n o f t h e D o c u m e n t m e a n s a n y w o r k c o n t a i n i n g t h e D o c u m e n t

o r a p o r t i o n o f i t , e i t h e r c o p i e d v e r b a t i m , o r w i t h m o d i c a t i o n s a n d / o r t r a n s l a t e d i n t o

a n o t h e r l a n g u a g e .

A S e c o n d a r y S e c t i o n i s a n a m e d a p p e n d i x o r a f r o n t - m a t t e r s e c t i o n o f t h e D o c -

u m e n t t h a t d e a l s e x c l u s i v e l y w i t h t h e r e l a t i o n s h i p o f t h e p u b l i s h e r s o r a u t h o r s o f t h e

D o c u m e n t t o t h e D o c u m e n t ' s o v e r a l l s u b j e c t ( o r t o r e l a t e d m a t t e r s ) a n d c o n t a i n s n o t h -

i n g t h a t c o u l d f a l l d i r e c t l y w i t h i n t h a t o v e r a l l s u b j e c t . ( T h u s , i f t h e D o c u m e n t i s i n p a r t

a t e x t b o o k o f m a t h e m a t i c s , a S e c o n d a r y S e c t i o n m a y n o t e x p l a i n a n y m a t h e m a t i c s . ) T h e

r e l a t i o n s h i p c o u l d b e a m a t t e r o f h i s t o r i c a l c o n n e c t i o n w i t h t h e s u b j e c t o r w i t h r e l a t e d

m a t t e r s , o r o f l e g a l , c o m m e r c i a l , p h i l o s o p h i c a l , e t h i c a l o r p o l i t i c a l p o s i t i o n r e g a r d i n g

t h e m .

T h e I n v a r i a n t S e c t i o n s a r e c e r t a i n S e c o n d a r y S e c t i o n s w h o s e t i t l e s a r e d e s i g n a t e d ,

a s b e i n g t h o s e o f I n v a r i a n t S e c t i o n s , i n t h e n o t i c e t h a t s a y s t h a t t h e D o c u m e n t i s r e l e a s e d

u n d e r t h i s L i c e n s e . I f a s e c t i o n d o e s n o t t t h e a b o v e d e n i t i o n o f S e c o n d a r y t h e n i t i s

n o t a l l o w e d t o b e d e s i g n a t e d a s I n v a r i a n t . T h e D o c u m e n t m a y c o n t a i n z e r o I n v a r i a n t

S e c t i o n s . I f t h e D o c u m e n t d o e s n o t i d e n t i f y a n y I n v a r i a n t S e c t i o n s t h e n t h e r e a r e n o n e .

T h e C o v e r T e x t s a r e c e r t a i n s h o r t p a s s a g e s o f t e x t t h a t a r e l i s t e d , a s F r o n t - C o v e r

T e x t s o r B a c k - C o v e r T e x t s , i n t h e n o t i c e t h a t s a y s t h a t t h e D o c u m e n t i s r e l e a s e d u n d e r

t h i s L i c e n s e . A F r o n t - C o v e r T e x t m a y b e a t m o s t 5 w o r d s , a n d a B a c k - C o v e r T e x t m a y

b e a t m o s t 2 5 w o r d s .

A T r a n s p a r e n t c o p y o f t h e D o c u m e n t m e a n s a m a c h i n e - r e a d a b l e c o p y , r e p r e s e n t e d

i n a f o r m a t w h o s e s p e c i c a t i o n i s a v a i l a b l e t o t h e g e n e r a l p u b l i c , t h a t i s s u i t a b l e f o r

r e v i s i n g t h e d o c u m e n t s t r a i g h t f o r w a r d l y w i t h g e n e r i c t e x t e d i t o r s o r ( f o r i m a g e s c o m -

p o s e d o f p i x e l s ) g e n e r i c p a i n t p r o g r a m s o r ( f o r d r a w i n g s ) s o m e w i d e l y a v a i l a b l e d r a w i n g

e d i t o r , a n d t h a t i s s u i t a b l e f o r i n p u t t o t e x t f o r m a t t e r s o r f o r a u t o m a t i c t r a n s l a t i o n t o

a v a r i e t y o f f o r m a t s s u i t a b l e f o r i n p u t t o t e x t f o r m a t t e r s . A c o p y m a d e i n a n o t h e r -

w i s e T r a n s p a r e n t l e f o r m a t w h o s e m a r k u p , o r a b s e n c e o f m a r k u p , h a s b e e n a r r a n g e d t o

t h w a r t o r d i s c o u r a g e s u b s e q u e n t m o d i c a t i o n b y r e a d e r s i s n o t T r a n s p a r e n t . A n i m a g e

f o r m a t i s n o t T r a n s p a r e n t i f u s e d f o r a n y s u b s t a n t i a l a m o u n t o f t e x t . A c o p y t h a t i s n o t

T r a n s p a r e n t i s c a l l e d O p a q u e .

E x a m p l e s o f s u i t a b l e f o r m a t s f o r T r a n s p a r e n t c o p i e s i n c l u d e p l a i n A S C I I w i t h o u t

m a r k u p , T e x i n f o i n p u t f o r m a t , L a T e X i n p u t f o r m a t , S G M L o r X M L u s i n g a p u b l i c l y

a v a i l a b l e D T D , a n d s t a n d a r d - c o n f o r m i n g s i m p l e H T M L , P o s t S c r i p t o r P D F d e s i g n e d

f o r h u m a n m o d i c a t i o n . E x a m p l e s o f t r a n s p a r e n t i m a g e f o r m a t s i n c l u d e P N G , X C F

a n d J P G . O p a q u e f o r m a t s i n c l u d e p r o p r i e t a r y f o r m a t s t h a t c a n b e r e a d a n d e d i t e d o n l y

b y p r o p r i e t a r y w o r d p r o c e s s o r s , S G M L o r X M L f o r w h i c h t h e D T D a n d / o r p r o c e s s i n g

t o o l s a r e n o t g e n e r a l l y a v a i l a b l e , a n d t h e m a c h i n e - g e n e r a t e d H T M L , P o s t S c r i p t o r P D F

p r o d u c e d b y s o m e w o r d p r o c e s s o r s f o r o u t p u t p u r p o s e s o n l y .

T h e T i t l e P a g e m e a n s , f o r a p r i n t e d b o o k , t h e t i t l e p a g e i t s e l f , p l u s s u c h f o l l o w i n g

p a g e s a s a r e n e e d e d t o h o l d , l e g i b l y , t h e m a t e r i a l t h i s L i c e n s e r e q u i r e s t o a p p e a r i n t h e

t i t l e p a g e . F o r w o r k s i n f o r m a t s w h i c h d o n o t h a v e a n y t i t l e p a g e a s s u c h , T i t l e P a g e

m e a n s t h e t e x t n e a r t h e m o s t p r o m i n e n t a p p e a r a n c e o f t h e w o r k ' s t i t l e , p r e c e d i n g t h e

b e g i n n i n g o f t h e b o d y o f t h e t e x t .

A s e c t i o n E n t i t l e d X Y Z m e a n s a n a m e d s u b u n i t o f t h e D o c u m e n t w h o s e t i t l e e i t h e r





i s p r e c i s e l y X Y Z o r c o n t a i n s X Y Z i n p a r e n t h e s e s f o l l o w i n g t e x t t h a t t r a n s l a t e s X Y Z

i n a n o t h e r l a n g u a g e . ( H e r e X Y Z s t a n d s f o r a s p e c i c s e c t i o n n a m e m e n t i o n e d b e l o w ,

s u c h a s A c k n o w l e d g e m e n t s , D e d i c a t i o n s , E n d o r s e m e n t s , o r H i s t o r y . ) T o

P r e s e r v e t h e T i t l e o f s u c h a s e c t i o n w h e n y o u m o d i f y t h e D o c u m e n t m e a n s t h a t i t

r e m a i n s a s e c t i o n E n t i t l e d X Y Z a c c o r d i n g t o t h i s d e n i t i o n .

T h e D o c u m e n t m a y i n c l u d e W a r r a n t y D i s c l a i m e r s n e x t t o t h e n o t i c e w h i c h s t a t e s t h a t

t h i s L i c e n s e a p p l i e s t o t h e D o c u m e n t . T h e s e W a r r a n t y D i s c l a i m e r s a r e c o n s i d e r e d t o b e

i n c l u d e d b y r e f e r e n c e i n t h i s L i c e n s e , b u t o n l y a s r e g a r d s d i s c l a i m i n g w a r r a n t i e s : a n y

o t h e r i m p l i c a t i o n t h a t t h e s e W a r r a n t y D i s c l a i m e r s m a y h a v e i s v o i d a n d h a s n o e e c t o n

t h e m e a n i n g o f t h i s L i c e n s e .

2 . V E R B A T I M C O P Y I N G

Y o u m a y c o p y a n d d i s t r i b u t e t h e D o c u m e n t i n a n y m e d i u m , e i t h e r c o m m e r c i a l l y o r

n o n c o m m e r c i a l l y , p r o v i d e d t h a t t h i s L i c e n s e , t h e c o p y r i g h t n o t i c e s , a n d t h e l i c e n s e n o t i c e

s a y i n g t h i s L i c e n s e a p p l i e s t o t h e D o c u m e n t a r e r e p r o d u c e d i n a l l c o p i e s , a n d t h a t y o u

a d d n o o t h e r c o n d i t i o n s w h a t s o e v e r t o t h o s e o f t h i s L i c e n s e . Y o u m a y n o t u s e t e c h n i c a l

m e a s u r e s t o o b s t r u c t o r c o n t r o l t h e r e a d i n g o r f u r t h e r c o p y i n g o f t h e c o p i e s y o u m a k e

o r d i s t r i b u t e . H o w e v e r , y o u m a y a c c e p t c o m p e n s a t i o n i n e x c h a n g e f o r c o p i e s . I f y o u

d i s t r i b u t e a l a r g e e n o u g h n u m b e r o f c o p i e s y o u m u s t a l s o f o l l o w t h e c o n d i t i o n s i n s e c t i o n

3 .

Y o u m a y a l s o l e n d c o p i e s , u n d e r t h e s a m e c o n d i t i o n s s t a t e d a b o v e , a n d y o u m a y

p u b l i c l y d i s p l a y c o p i e s .

3 . C O P Y I N G I N Q U A N T I T Y

I f y o u p u b l i s h p r i n t e d c o p i e s ( o r c o p i e s i n m e d i a t h a t c o m m o n l y h a v e p r i n t e d c o v e r s ) o f

t h e D o c u m e n t , n u m b e r i n g m o r e t h a n 1 0 0 , a n d t h e D o c u m e n t ' s l i c e n s e n o t i c e r e q u i r e s

C o v e r T e x t s , y o u m u s t e n c l o s e t h e c o p i e s i n c o v e r s t h a t c a r r y , c l e a r l y a n d l e g i b l y , a l l

t h e s e C o v e r T e x t s : F r o n t - C o v e r T e x t s o n t h e f r o n t c o v e r , a n d B a c k - C o v e r T e x t s o n t h e

b a c k c o v e r . B o t h c o v e r s m u s t a l s o c l e a r l y a n d l e g i b l y i d e n t i f y y o u a s t h e p u b l i s h e r o f

t h e s e c o p i e s . T h e f r o n t c o v e r m u s t p r e s e n t t h e f u l l t i t l e w i t h a l l w o r d s o f t h e t i t l e e q u a l l y

p r o m i n e n t a n d v i s i b l e . Y o u m a y a d d o t h e r m a t e r i a l o n t h e c o v e r s i n a d d i t i o n . C o p y i n g

w i t h c h a n g e s l i m i t e d t o t h e c o v e r s , a s l o n g a s t h e y p r e s e r v e t h e t i t l e o f t h e D o c u m e n t

a n d s a t i s f y t h e s e c o n d i t i o n s , c a n b e t r e a t e d a s v e r b a t i m c o p y i n g i n o t h e r r e s p e c t s .

I f t h e r e q u i r e d t e x t s f o r e i t h e r c o v e r a r e t o o v o l u m i n o u s t o t l e g i b l y , y o u s h o u l d p u t

t h e r s t o n e s l i s t e d ( a s m a n y a s t r e a s o n a b l y ) o n t h e a c t u a l c o v e r , a n d c o n t i n u e t h e r e s t

o n t o a d j a c e n t p a g e s .

I f y o u p u b l i s h o r d i s t r i b u t e O p a q u e c o p i e s o f t h e D o c u m e n t n u m b e r i n g m o r e t h a n 1 0 0 ,

y o u m u s t e i t h e r i n c l u d e a m a c h i n e - r e a d a b l e T r a n s p a r e n t c o p y a l o n g w i t h e a c h O p a q u e

c o p y , o r s t a t e i n o r w i t h e a c h O p a q u e c o p y a c o m p u t e r - n e t w o r k l o c a t i o n f r o m w h i c h

t h e g e n e r a l n e t w o r k - u s i n g p u b l i c h a s a c c e s s t o d o w n l o a d u s i n g p u b l i c - s t a n d a r d n e t w o r k

p r o t o c o l s a c o m p l e t e T r a n s p a r e n t c o p y o f t h e D o c u m e n t , f r e e o f a d d e d m a t e r i a l . I f

y o u u s e t h e l a t t e r o p t i o n , y o u m u s t t a k e r e a s o n a b l y p r u d e n t s t e p s , w h e n y o u b e g i n





d i s t r i b u t i o n o f O p a q u e c o p i e s i n q u a n t i t y , t o e n s u r e t h a t t h i s T r a n s p a r e n t c o p y w i l l

r e m a i n t h u s a c c e s s i b l e a t t h e s t a t e d l o c a t i o n u n t i l a t l e a s t o n e y e a r a f t e r t h e l a s t t i m e

y o u d i s t r i b u t e a n O p a q u e c o p y ( d i r e c t l y o r t h r o u g h y o u r a g e n t s o r r e t a i l e r s ) o f t h a t

e d i t i o n t o t h e p u b l i c .

I t i s r e q u e s t e d , b u t n o t r e q u i r e d , t h a t y o u c o n t a c t t h e a u t h o r s o f t h e D o c u m e n t w e l l

b e f o r e r e d i s t r i b u t i n g a n y l a r g e n u m b e r o f c o p i e s , t o g i v e t h e m a c h a n c e t o p r o v i d e y o u

w i t h a n u p d a t e d v e r s i o n o f t h e D o c u m e n t .

4 . M O D I F I C A T I O N S

Y o u m a y c o p y a n d d i s t r i b u t e a M o d i e d V e r s i o n o f t h e D o c u m e n t u n d e r t h e c o n d i t i o n s

o f s e c t i o n s 2 a n d 3 a b o v e , p r o v i d e d t h a t y o u r e l e a s e t h e M o d i e d V e r s i o n u n d e r p r e c i s e l y

t h i s L i c e n s e , w i t h t h e M o d i e d V e r s i o n l l i n g t h e r o l e o f t h e D o c u m e n t , t h u s l i c e n s i n g

d i s t r i b u t i o n a n d m o d i c a t i o n o f t h e M o d i e d V e r s i o n t o w h o e v e r p o s s e s s e s a c o p y o f i t .

I n a d d i t i o n , y o u m u s t d o t h e s e t h i n g s i n t h e M o d i e d V e r s i o n :

A . U s e i n t h e T i t l e P a g e ( a n d o n t h e c o v e r s , i f a n y ) a t i t l e d i s t i n c t f r o m t h a t o f t h e

D o c u m e n t , a n d f r o m t h o s e o f p r e v i o u s v e r s i o n s ( w h i c h s h o u l d , i f t h e r e w e r e a n y ,

b e l i s t e d i n t h e H i s t o r y s e c t i o n o f t h e D o c u m e n t ) . Y o u m a y u s e t h e s a m e t i t l e a s

a p r e v i o u s v e r s i o n i f t h e o r i g i n a l p u b l i s h e r o f t h a t v e r s i o n g i v e s p e r m i s s i o n .

B . L i s t o n t h e T i t l e P a g e , a s a u t h o r s , o n e o r m o r e p e r s o n s o r e n t i t i e s r e s p o n s i b l e f o r

a u t h o r s h i p o f t h e m o d i c a t i o n s i n t h e M o d i e d V e r s i o n , t o g e t h e r w i t h a t l e a s t v e

o f t h e p r i n c i p a l a u t h o r s o f t h e D o c u m e n t ( a l l o f i t s p r i n c i p a l a u t h o r s , i f i t h a s f e w e r

t h a n v e ) , u n l e s s t h e y r e l e a s e y o u f r o m t h i s r e q u i r e m e n t .

C . S t a t e o n t h e T i t l e p a g e t h e n a m e o f t h e p u b l i s h e r o f t h e M o d i e d V e r s i o n , a s t h e

p u b l i s h e r .

D . P r e s e r v e a l l t h e c o p y r i g h t n o t i c e s o f t h e D o c u m e n t .

E . A d d a n a p p r o p r i a t e c o p y r i g h t n o t i c e f o r y o u r m o d i c a t i o n s a d j a c e n t t o t h e o t h e r

c o p y r i g h t n o t i c e s .

F . I n c l u d e , i m m e d i a t e l y a f t e r t h e c o p y r i g h t n o t i c e s , a l i c e n s e n o t i c e g i v i n g t h e p u b l i c

p e r m i s s i o n t o u s e t h e M o d i e d V e r s i o n u n d e r t h e t e r m s o f t h i s L i c e n s e , i n t h e f o r m

s h o w n i n t h e A d d e n d u m b e l o w .

G . P r e s e r v e i n t h a t l i c e n s e n o t i c e t h e f u l l l i s t s o f I n v a r i a n t S e c t i o n s a n d r e q u i r e d C o v e r

T e x t s g i v e n i n t h e D o c u m e n t ' s l i c e n s e n o t i c e .

H . I n c l u d e a n u n a l t e r e d c o p y o f t h i s L i c e n s e .

I . P r e s e r v e t h e s e c t i o n E n t i t l e d H i s t o r y , P r e s e r v e i t s T i t l e , a n d a d d t o i t a n i t e m

s t a t i n g a t l e a s t t h e t i t l e , y e a r , n e w a u t h o r s , a n d p u b l i s h e r o f t h e M o d i e d V e r s i o n a s

g i v e n o n t h e T i t l e P a g e . I f t h e r e i s n o s e c t i o n E n t i t l e d H i s t o r y i n t h e D o c u m e n t ,

c r e a t e o n e s t a t i n g t h e t i t l e , y e a r , a u t h o r s , a n d p u b l i s h e r o f t h e D o c u m e n t a s g i v e n





o n i t s T i t l e P a g e , t h e n a d d a n i t e m d e s c r i b i n g t h e M o d i e d V e r s i o n a s s t a t e d i n

t h e p r e v i o u s s e n t e n c e .

J . P r e s e r v e t h e n e t w o r k l o c a t i o n , i f a n y , g i v e n i n t h e D o c u m e n t f o r p u b l i c a c c e s s t o

a T r a n s p a r e n t c o p y o f t h e D o c u m e n t , a n d l i k e w i s e t h e n e t w o r k l o c a t i o n s g i v e n i n

t h e D o c u m e n t f o r p r e v i o u s v e r s i o n s i t w a s b a s e d o n . T h e s e m a y b e p l a c e d i n t h e

H i s t o r y s e c t i o n . Y o u m a y o m i t a n e t w o r k l o c a t i o n f o r a w o r k t h a t w a s p u b l i s h e d

a t l e a s t f o u r y e a r s b e f o r e t h e D o c u m e n t i t s e l f , o r i f t h e o r i g i n a l p u b l i s h e r o f t h e

v e r s i o n i t r e f e r s t o g i v e s p e r m i s s i o n .

K . F o r a n y s e c t i o n E n t i t l e d A c k n o w l e d g e m e n t s o r D e d i c a t i o n s , P r e s e r v e t h e T i t l e

o f t h e s e c t i o n , a n d p r e s e r v e i n t h e s e c t i o n a l l t h e s u b s t a n c e a n d t o n e o f e a c h o f t h e

c o n t r i b u t o r a c k n o w l e d g e m e n t s a n d / o r d e d i c a t i o n s g i v e n t h e r e i n .

L . P r e s e r v e a l l t h e I n v a r i a n t S e c t i o n s o f t h e D o c u m e n t , u n a l t e r e d i n t h e i r t e x t a n d

i n t h e i r t i t l e s . S e c t i o n n u m b e r s o r t h e e q u i v a l e n t a r e n o t c o n s i d e r e d p a r t o f t h e

s e c t i o n t i t l e s .

M . D e l e t e a n y s e c t i o n E n t i t l e d E n d o r s e m e n t s . S u c h a s e c t i o n m a y n o t b e i n c l u d e d

i n t h e M o d i e d V e r s i o n .

N . D o n o t r e t i t l e a n y e x i s t i n g s e c t i o n t o b e E n t i t l e d E n d o r s e m e n t s o r t o c o n i c t i n

t i t l e w i t h a n y I n v a r i a n t S e c t i o n .

O . P r e s e r v e a n y W a r r a n t y D i s c l a i m e r s .

I f t h e M o d i e d V e r s i o n i n c l u d e s n e w f r o n t - m a t t e r s e c t i o n s o r a p p e n d i c e s t h a t q u a l i f y

a s S e c o n d a r y S e c t i o n s a n d c o n t a i n n o m a t e r i a l c o p i e d f r o m t h e D o c u m e n t , y o u m a y a t

y o u r o p t i o n d e s i g n a t e s o m e o r a l l o f t h e s e s e c t i o n s a s i n v a r i a n t . T o d o t h i s , a d d t h e i r

t i t l e s t o t h e l i s t o f I n v a r i a n t S e c t i o n s i n t h e M o d i e d V e r s i o n ' s l i c e n s e n o t i c e . T h e s e t i t l e s

m u s t b e d i s t i n c t f r o m a n y o t h e r s e c t i o n t i t l e s .

Y o u m a y a d d a s e c t i o n E n t i t l e d E n d o r s e m e n t s , p r o v i d e d i t c o n t a i n s n o t h i n g b u t

e n d o r s e m e n t s o f y o u r M o d i e d V e r s i o n b y v a r i o u s p a r t i e s f o r e x a m p l e , s t a t e m e n t s o f

p e e r r e v i e w o r t h a t t h e t e x t h a s b e e n a p p r o v e d b y a n o r g a n i z a t i o n a s t h e a u t h o r i t a t i v e

d e n i t i o n o f a s t a n d a r d .

Y o u m a y a d d a p a s s a g e o f u p t o v e w o r d s a s a F r o n t - C o v e r T e x t , a n d a p a s s a g e o f u p

t o 2 5 w o r d s a s a B a c k - C o v e r T e x t , t o t h e e n d o f t h e l i s t o f C o v e r T e x t s i n t h e M o d i e d

V e r s i o n . O n l y o n e p a s s a g e o f F r o n t - C o v e r T e x t a n d o n e o f B a c k - C o v e r T e x t m a y b e

a d d e d b y ( o r t h r o u g h a r r a n g e m e n t s m a d e b y ) a n y o n e e n t i t y . I f t h e D o c u m e n t a l r e a d y

i n c l u d e s a c o v e r t e x t f o r t h e s a m e c o v e r , p r e v i o u s l y a d d e d b y y o u o r b y a r r a n g e m e n t

m a d e b y t h e s a m e e n t i t y y o u a r e a c t i n g o n b e h a l f o f , y o u m a y n o t a d d a n o t h e r ; b u t y o u

m a y r e p l a c e t h e o l d o n e , o n e x p l i c i t p e r m i s s i o n f r o m t h e p r e v i o u s p u b l i s h e r t h a t a d d e d

t h e o l d o n e .

T h e a u t h o r ( s ) a n d p u b l i s h e r ( s ) o f t h e D o c u m e n t d o n o t b y t h i s L i c e n s e g i v e p e r m i s s i o n

t o u s e t h e i r n a m e s f o r p u b l i c i t y f o r o r t o a s s e r t o r i m p l y e n d o r s e m e n t o f a n y M o d i e d

V e r s i o n .





5 . C O M B I N I N G D O C U M E N T S

Y o u m a y c o m b i n e t h e D o c u m e n t w i t h o t h e r d o c u m e n t s r e l e a s e d u n d e r t h i s L i c e n s e , u n d e r

t h e t e r m s d e n e d i n s e c t i o n 4 a b o v e f o r m o d i e d v e r s i o n s , p r o v i d e d t h a t y o u i n c l u d e i n

t h e c o m b i n a t i o n a l l o f t h e I n v a r i a n t S e c t i o n s o f a l l o f t h e o r i g i n a l d o c u m e n t s , u n m o d i e d ,

a n d l i s t t h e m a l l a s I n v a r i a n t S e c t i o n s o f y o u r c o m b i n e d w o r k i n i t s l i c e n s e n o t i c e , a n d

t h a t y o u p r e s e r v e a l l t h e i r W a r r a n t y D i s c l a i m e r s .

T h e c o m b i n e d w o r k n e e d o n l y c o n t a i n o n e c o p y o f t h i s L i c e n s e , a n d m u l t i p l e i d e n t i c a l

I n v a r i a n t S e c t i o n s m a y b e r e p l a c e d w i t h a s i n g l e c o p y . I f t h e r e a r e m u l t i p l e I n v a r i a n t

S e c t i o n s w i t h t h e s a m e n a m e b u t d i e r e n t c o n t e n t s , m a k e t h e t i t l e o f e a c h s u c h s e c t i o n

u n i q u e b y a d d i n g a t t h e e n d o f i t , i n p a r e n t h e s e s , t h e n a m e o f t h e o r i g i n a l a u t h o r o r

p u b l i s h e r o f t h a t s e c t i o n i f k n o w n , o r e l s e a u n i q u e n u m b e r . M a k e t h e s a m e a d j u s t m e n t

t o t h e s e c t i o n t i t l e s i n t h e l i s t o f I n v a r i a n t S e c t i o n s i n t h e l i c e n s e n o t i c e o f t h e c o m b i n e d

w o r k .

I n t h e c o m b i n a t i o n , y o u m u s t c o m b i n e a n y s e c t i o n s E n t i t l e d H i s t o r y i n t h e v a r i o u s

o r i g i n a l d o c u m e n t s , f o r m i n g o n e s e c t i o n E n t i t l e d H i s t o r y ; l i k e w i s e c o m b i n e a n y s e c t i o n s

E n t i t l e d A c k n o w l e d g e m e n t s , a n d a n y s e c t i o n s E n t i t l e d D e d i c a t i o n s . Y o u m u s t d e l e t e

a l l s e c t i o n s E n t i t l e d E n d o r s e m e n t s .

6 . C O L L E C T I O N S O F D O C U M E N T S

Y o u m a y m a k e a c o l l e c t i o n c o n s i s t i n g o f t h e D o c u m e n t a n d o t h e r d o c u m e n t s r e l e a s e d

u n d e r t h i s L i c e n s e , a n d r e p l a c e t h e i n d i v i d u a l c o p i e s o f t h i s L i c e n s e i n t h e v a r i o u s d o c u -

m e n t s w i t h a s i n g l e c o p y t h a t i s i n c l u d e d i n t h e c o l l e c t i o n , p r o v i d e d t h a t y o u f o l l o w t h e

r u l e s o f t h i s L i c e n s e f o r v e r b a t i m c o p y i n g o f e a c h o f t h e d o c u m e n t s i n a l l o t h e r r e s p e c t s .

Y o u m a y e x t r a c t a s i n g l e d o c u m e n t f r o m s u c h a c o l l e c t i o n , a n d d i s t r i b u t e i t i n d i v i d u a l l y

u n d e r t h i s L i c e n s e , p r o v i d e d y o u i n s e r t a c o p y o f t h i s L i c e n s e i n t o t h e e x t r a c t e d d o c u m e n t ,

a n d f o l l o w t h i s L i c e n s e i n a l l o t h e r r e s p e c t s r e g a r d i n g v e r b a t i m c o p y i n g o f t h a t d o c u m e n t .

7 . A G G R E G A T I O N W I T H I N D E P E N D E N T W O R K S

A c o m p i l a t i o n o f t h e D o c u m e n t o r i t s d e r i v a t i v e s w i t h o t h e r s e p a r a t e a n d i n d e p e n d e n t

d o c u m e n t s o r w o r k s , i n o r o n a v o l u m e o f a s t o r a g e o r d i s t r i b u t i o n m e d i u m , i s c a l l e d a n

a g g r e g a t e i f t h e c o p y r i g h t r e s u l t i n g f r o m t h e c o m p i l a t i o n i s n o t u s e d t o l i m i t t h e l e g a l

r i g h t s o f t h e c o m p i l a t i o n ' s u s e r s b e y o n d w h a t t h e i n d i v i d u a l w o r k s p e r m i t . W h e n t h e

D o c u m e n t i s i n c l u d e d i n a n a g g r e g a t e , t h i s L i c e n s e d o e s n o t a p p l y t o t h e o t h e r w o r k s i n

t h e a g g r e g a t e w h i c h a r e n o t t h e m s e l v e s d e r i v a t i v e w o r k s o f t h e D o c u m e n t .

I f t h e C o v e r T e x t r e q u i r e m e n t o f s e c t i o n 3 i s a p p l i c a b l e t o t h e s e c o p i e s o f t h e D o c u m e n t ,

t h e n i f t h e D o c u m e n t i s l e s s t h a n o n e h a l f o f t h e e n t i r e a g g r e g a t e , t h e D o c u m e n t ' s C o v e r

T e x t s m a y b e p l a c e d o n c o v e r s t h a t b r a c k e t t h e D o c u m e n t w i t h i n t h e a g g r e g a t e , o r t h e

e l e c t r o n i c e q u i v a l e n t o f c o v e r s i f t h e D o c u m e n t i s i n e l e c t r o n i c f o r m . O t h e r w i s e t h e y

m u s t a p p e a r o n p r i n t e d c o v e r s t h a t b r a c k e t t h e w h o l e a g g r e g a t e .





8 . T R A N S L A T I O N

T r a n s l a t i o n i s c o n s i d e r e d a k i n d o f m o d i c a t i o n , s o y o u m a y d i s t r i b u t e t r a n s l a t i o n s o f t h e

D o c u m e n t u n d e r t h e t e r m s o f s e c t i o n 4 . R e p l a c i n g I n v a r i a n t S e c t i o n s w i t h t r a n s l a t i o n s

r e q u i r e s s p e c i a l p e r m i s s i o n f r o m t h e i r c o p y r i g h t h o l d e r s , b u t y o u m a y i n c l u d e t r a n s l a t i o n s

o f s o m e o r a l l I n v a r i a n t S e c t i o n s i n a d d i t i o n t o t h e o r i g i n a l v e r s i o n s o f t h e s e I n v a r i a n t

S e c t i o n s . Y o u m a y i n c l u d e a t r a n s l a t i o n o f t h i s L i c e n s e , a n d a l l t h e l i c e n s e n o t i c e s i n t h e

D o c u m e n t , a n d a n y W a r r a n t y D i s c l a i m e r s , p r o v i d e d t h a t y o u a l s o i n c l u d e t h e o r i g i n a l

E n g l i s h v e r s i o n o f t h i s L i c e n s e a n d t h e o r i g i n a l v e r s i o n s o f t h o s e n o t i c e s a n d d i s c l a i m e r s .

I n c a s e o f a d i s a g r e e m e n t b e t w e e n t h e t r a n s l a t i o n a n d t h e o r i g i n a l v e r s i o n o f t h i s L i c e n s e

o r a n o t i c e o r d i s c l a i m e r , t h e o r i g i n a l v e r s i o n w i l l p r e v a i l .

I f a s e c t i o n i n t h e D o c u m e n t i s E n t i t l e d A c k n o w l e d g e m e n t s , D e d i c a t i o n s , o r H i s -

t o r y , t h e r e q u i r e m e n t ( s e c t i o n 4 ) t o P r e s e r v e i t s T i t l e ( s e c t i o n 1 ) w i l l t y p i c a l l y r e q u i r e

c h a n g i n g t h e a c t u a l t i t l e .

9 . T E R M I N A T I O N

Y o u m a y n o t c o p y , m o d i f y , s u b l i c e n s e , o r d i s t r i b u t e t h e D o c u m e n t e x c e p t a s e x p r e s s l y

p r o v i d e d f o r u n d e r t h i s L i c e n s e . A n y o t h e r a t t e m p t t o c o p y , m o d i f y , s u b l i c e n s e o r d i s -

t r i b u t e t h e D o c u m e n t i s v o i d , a n d w i l l a u t o m a t i c a l l y t e r m i n a t e y o u r r i g h t s u n d e r t h i s

L i c e n s e . H o w e v e r , p a r t i e s w h o h a v e r e c e i v e d c o p i e s , o r r i g h t s , f r o m y o u u n d e r t h i s L i c e n s e

w i l l n o t h a v e t h e i r l i c e n s e s t e r m i n a t e d s o l o n g a s s u c h p a r t i e s r e m a i n i n f u l l c o m p l i a n c e .

1 0 . F U T U R E R E V I S I O N S O F T H I S L I C E N S E

T h e F r e e S o f t w a r e F o u n d a t i o n m a y p u b l i s h n e w , r e v i s e d v e r s i o n s o f t h e G N U F r e e D o c -

u m e n t a t i o n L i c e n s e f r o m t i m e t o t i m e . S u c h n e w v e r s i o n s w i l l b e s i m i l a r i n s p i r i t t o

t h e p r e s e n t v e r s i o n , b u t m a y d i e r i n d e t a i l t o a d d r e s s n e w p r o b l e m s o r c o n c e r n s . S e e

h t t p : / / w w w . g n u . o r g / c o p y l e f t / .

E a c h v e r s i o n o f t h e L i c e n s e i s g i v e n a d i s t i n g u i s h i n g v e r s i o n n u m b e r . I f t h e D o c u m e n t

s p e c i e s t h a t a p a r t i c u l a r n u m b e r e d v e r s i o n o f t h i s L i c e n s e o r a n y l a t e r v e r s i o n a p p l i e s

t o i t , y o u h a v e t h e o p t i o n o f f o l l o w i n g t h e t e r m s a n d c o n d i t i o n s e i t h e r o f t h a t s p e c i e d

v e r s i o n o r o f a n y l a t e r v e r s i o n t h a t h a s b e e n p u b l i s h e d ( n o t a s a d r a f t ) b y t h e F r e e S o f t -

w a r e F o u n d a t i o n . I f t h e D o c u m e n t d o e s n o t s p e c i f y a v e r s i o n n u m b e r o f t h i s L i c e n s e , y o u

m a y c h o o s e a n y v e r s i o n e v e r p u b l i s h e d ( n o t a s a d r a f t ) b y t h e F r e e S o f t w a r e F o u n d a t i o n .

A D D E N D U M : H o w t o u s e t h i s L i c e n s e f o r y o u r d o c u m e n t s

T o u s e t h i s L i c e n s e i n a d o c u m e n t y o u h a v e w r i t t e n , i n c l u d e a c o p y o f t h e L i c e n s e i n t h e

d o c u m e n t a n d p u t t h e f o l l o w i n g c o p y r i g h t a n d l i c e n s e n o t i c e s j u s t a f t e r t h e t i t l e p a g e :

C o p y r i g h t

c Y E A R Y O U R N A M E . P e r m i s s i o n i s g r a n t e d t o c o p y , d i s t r i b u t e

a n d / o r m o d i f y t h i s d o c u m e n t u n d e r t h e t e r m s o f t h e G N U F r e e D o c u m e n t a -

t i o n L i c e n s e , V e r s i o n 1 . 2 o r a n y l a t e r v e r s i o n p u b l i s h e d b y t h e F r e e S o f t w a r e





F o u n d a t i o n ; w i t h n o I n v a r i a n t S e c t i o n s , n o F r o n t - C o v e r T e x t s , a n d n o B a c k -

C o v e r T e x t s . A c o p y o f t h e l i c e n s e i s i n c l u d e d i n t h e s e c t i o n e n t i t l e d G N U

F r e e D o c u m e n t a t i o n L i c e n s e .

I f y o u h a v e I n v a r i a n t S e c t i o n s , F r o n t - C o v e r T e x t s a n d B a c k - C o v e r T e x t s , r e p l a c e t h e

w i t h . . . T e x t s . l i n e w i t h t h i s :

w i t h t h e I n v a r i a n t S e c t i o n s b e i n g L I S T T H E I R T I T L E S , w i t h t h e F r o n t -

C o v e r T e x t s b e i n g L I S T , a n d w i t h t h e B a c k - C o v e r T e x t s b e i n g L I S T .

I f y o u h a v e I n v a r i a n t S e c t i o n s w i t h o u t C o v e r T e x t s , o r s o m e o t h e r c o m b i n a t i o n o f t h e

t h r e e , m e r g e t h o s e t w o a l t e r n a t i v e s t o s u i t t h e s i t u a t i o n .

I f y o u r d o c u m e n t c o n t a i n s n o n t r i v i a l e x a m p l e s o f p r o g r a m c o d e , w e r e c o m m e n d r e -

l e a s i n g t h e s e e x a m p l e s i n p a r a l l e l u n d e r y o u r c h o i c e o f f r e e s o f t w a r e l i c e n s e , s u c h a s t h e

G N U G e n e r a l P u b l i c L i c e n s e , t o p e r m i t t h e i r u s e i n f r e e s o f t w a r e .





G . 2 . T h e G N U G e n e r a l P u b l i c L i c e n s e

V e r s i o n 2 , J u n e 1 9 9 1

C o p y r i g h t

c 1 9 8 9 , 1 9 9 1 F r e e S o f t w a r e F o u n d a t i o n , I n c .

5 1 F r a n k l i n S t r e e t , F i f t h F l o o r , B o s t o n , M A 0 2 1 1 0 - 1 3 0 1 , U S A

E v e r y o n e i s p e r m i t t e d t o c o p y a n d d i s t r i b u t e v e r b a t i m c o p i e s o f t h i s l i c e n s e d o c u m e n t ,

b u t c h a n g i n g i t i s n o t a l l o w e d .

P r e a m b l e

T h e l i c e n s e s f o r m o s t s o f t w a r e a r e d e s i g n e d t o t a k e a w a y y o u r f r e e d o m t o s h a r e a n d

c h a n g e i t . B y c o n t r a s t , t h e G N U G e n e r a l P u b l i c L i c e n s e i s i n t e n d e d t o g u a r a n t e e y o u r

f r e e d o m t o s h a r e a n d c h a n g e f r e e s o f t w a r e t o m a k e s u r e t h e s o f t w a r e i s f r e e f o r a l l i t s

u s e r s . T h i s G e n e r a l P u b l i c L i c e n s e a p p l i e s t o m o s t o f t h e F r e e S o f t w a r e F o u n d a t i o n ' s

s o f t w a r e a n d t o a n y o t h e r p r o g r a m w h o s e a u t h o r s c o m m i t t o u s i n g i t . ( S o m e o t h e r F r e e

S o f t w a r e F o u n d a t i o n s o f t w a r e i s c o v e r e d b y t h e G N U L i b r a r y G e n e r a l P u b l i c L i c e n s e

i n s t e a d . ) Y o u c a n a p p l y i t t o y o u r p r o g r a m s , t o o .

W h e n w e s p e a k o f f r e e s o f t w a r e , w e a r e r e f e r r i n g t o f r e e d o m , n o t p r i c e . O u r G e n e r a l

P u b l i c L i c e n s e s a r e d e s i g n e d t o m a k e s u r e t h a t y o u h a v e t h e f r e e d o m t o d i s t r i b u t e c o p i e s

o f f r e e s o f t w a r e ( a n d c h a r g e f o r t h i s s e r v i c e i f y o u w i s h ) , t h a t y o u r e c e i v e s o u r c e c o d e o r

c a n g e t i t i f y o u w a n t i t , t h a t y o u c a n c h a n g e t h e s o f t w a r e o r u s e p i e c e s o f i t i n n e w f r e e

p r o g r a m s ; a n d t h a t y o u k n o w y o u c a n d o t h e s e t h i n g s .

T o p r o t e c t y o u r r i g h t s , w e n e e d t o m a k e r e s t r i c t i o n s t h a t f o r b i d a n y o n e t o d e n y y o u

t h e s e r i g h t s o r t o a s k y o u t o s u r r e n d e r t h e r i g h t s . T h e s e r e s t r i c t i o n s t r a n s l a t e t o c e r t a i n

r e s p o n s i b i l i t i e s f o r y o u i f y o u d i s t r i b u t e c o p i e s o f t h e s o f t w a r e , o r i f y o u m o d i f y i t .

F o r e x a m p l e , i f y o u d i s t r i b u t e c o p i e s o f s u c h a p r o g r a m , w h e t h e r g r a t i s o r f o r a f e e ,

y o u m u s t g i v e t h e r e c i p i e n t s a l l t h e r i g h t s t h a t y o u h a v e . Y o u m u s t m a k e s u r e t h a t t h e y ,

t o o , r e c e i v e o r c a n g e t t h e s o u r c e c o d e . A n d y o u m u s t s h o w t h e m t h e s e t e r m s s o t h e y

k n o w t h e i r r i g h t s .

W e p r o t e c t y o u r r i g h t s w i t h t w o s t e p s : ( 1 ) c o p y r i g h t t h e s o f t w a r e , a n d ( 2 ) o e r y o u t h i s

l i c e n s e w h i c h g i v e s y o u l e g a l p e r m i s s i o n t o c o p y , d i s t r i b u t e a n d / o r m o d i f y t h e s o f t w a r e .

A l s o , f o r e a c h a u t h o r ' s p r o t e c t i o n a n d o u r s , w e w a n t t o m a k e c e r t a i n t h a t e v e r y o n e

u n d e r s t a n d s t h a t t h e r e i s n o w a r r a n t y f o r t h i s f r e e s o f t w a r e . I f t h e s o f t w a r e i s m o d i e d

b y s o m e o n e e l s e a n d p a s s e d o n , w e w a n t i t s r e c i p i e n t s t o k n o w t h a t w h a t t h e y h a v e i s n o t

t h e o r i g i n a l , s o t h a t a n y p r o b l e m s i n t r o d u c e d b y o t h e r s w i l l n o t r e e c t o n t h e o r i g i n a l

a u t h o r s ' r e p u t a t i o n s .

F i n a l l y , a n y f r e e p r o g r a m i s t h r e a t e n e d c o n s t a n t l y b y s o f t w a r e p a t e n t s . W e w i s h t o

a v o i d t h e d a n g e r t h a t r e d i s t r i b u t o r s o f a f r e e p r o g r a m w i l l i n d i v i d u a l l y o b t a i n p a t e n t

l i c e n s e s , i n e e c t m a k i n g t h e p r o g r a m p r o p r i e t a r y . T o p r e v e n t t h i s , w e h a v e m a d e i t

c l e a r t h a t a n y p a t e n t m u s t b e l i c e n s e d f o r e v e r y o n e ' s f r e e u s e o r n o t l i c e n s e d a t a l l .

T h e p r e c i s e t e r m s a n d c o n d i t i o n s f o r c o p y i n g , d i s t r i b u t i o n a n d m o d i c a t i o n f o l l o w .

G N U G e n e r a l P u b l i c L i c e n s e





T e r m s a n d C o n d i t i o n s F o r C o p y i n g , D i s t r i b u t i o n a n d

M o d i f i c a t i o n

0 . T h i s L i c e n s e a p p l i e s t o a n y p r o g r a m o r o t h e r w o r k w h i c h c o n t a i n s a n o t i c e p l a c e d

b y t h e c o p y r i g h t h o l d e r s a y i n g i t m a y b e d i s t r i b u t e d u n d e r t h e t e r m s o f t h i s G e n e r a l

P u b l i c L i c e n s e . T h e P r o g r a m , b e l o w , r e f e r s t o a n y s u c h p r o g r a m o r w o r k , a n d

a w o r k b a s e d o n t h e P r o g r a m m e a n s e i t h e r t h e P r o g r a m o r a n y d e r i v a t i v e w o r k

u n d e r c o p y r i g h t l a w : t h a t i s t o s a y , a w o r k c o n t a i n i n g t h e P r o g r a m o r a p o r t i o n o f

i t , e i t h e r v e r b a t i m o r w i t h m o d i c a t i o n s a n d / o r t r a n s l a t e d i n t o a n o t h e r l a n g u a g e .

( H e r e i n a f t e r , t r a n s l a t i o n i s i n c l u d e d w i t h o u t l i m i t a t i o n i n t h e t e r m m o d i c a t i o n . )

E a c h l i c e n s e e i s a d d r e s s e d a s y o u .

A c t i v i t i e s o t h e r t h a n c o p y i n g , d i s t r i b u t i o n a n d m o d i c a t i o n a r e n o t c o v e r e d b y t h i s

L i c e n s e ; t h e y a r e o u t s i d e i t s s c o p e . T h e a c t o f r u n n i n g t h e P r o g r a m i s n o t r e s t r i c t e d ,

a n d t h e o u t p u t f r o m t h e P r o g r a m i s c o v e r e d o n l y i f i t s c o n t e n t s c o n s t i t u t e a w o r k

b a s e d o n t h e P r o g r a m ( i n d e p e n d e n t o f h a v i n g b e e n m a d e b y r u n n i n g t h e P r o g r a m ) .

W h e t h e r t h a t i s t r u e d e p e n d s o n w h a t t h e P r o g r a m d o e s .

1 . Y o u m a y c o p y a n d d i s t r i b u t e v e r b a t i m c o p i e s o f t h e P r o g r a m ' s s o u r c e c o d e a s

y o u r e c e i v e i t , i n a n y m e d i u m , p r o v i d e d t h a t y o u c o n s p i c u o u s l y a n d a p p r o p r i a t e l y

p u b l i s h o n e a c h c o p y a n a p p r o p r i a t e c o p y r i g h t n o t i c e a n d d i s c l a i m e r o f w a r r a n t y ;

k e e p i n t a c t a l l t h e n o t i c e s t h a t r e f e r t o t h i s L i c e n s e a n d t o t h e a b s e n c e o f a n y

w a r r a n t y ; a n d g i v e a n y o t h e r r e c i p i e n t s o f t h e P r o g r a m a c o p y o f t h i s L i c e n s e a l o n g

w i t h t h e P r o g r a m .

Y o u m a y c h a r g e a f e e f o r t h e p h y s i c a l a c t o f t r a n s f e r r i n g a c o p y , a n d y o u m a y a t

y o u r o p t i o n o e r w a r r a n t y p r o t e c t i o n i n e x c h a n g e f o r a f e e .

2 . Y o u m a y m o d i f y y o u r c o p y o r c o p i e s o f t h e P r o g r a m o r a n y p o r t i o n o f i t , t h u s

f o r m i n g a w o r k b a s e d o n t h e P r o g r a m , a n d c o p y a n d d i s t r i b u t e s u c h m o d i c a t i o n s

o r w o r k u n d e r t h e t e r m s o f S e c t i o n 1 a b o v e , p r o v i d e d t h a t y o u a l s o m e e t a l l o f

t h e s e c o n d i t i o n s :

a ) Y o u m u s t c a u s e t h e m o d i e d l e s t o c a r r y p r o m i n e n t n o t i c e s s t a t i n g t h a t y o u

c h a n g e d t h e l e s a n d t h e d a t e o f a n y c h a n g e .

b ) Y o u m u s t c a u s e a n y w o r k t h a t y o u d i s t r i b u t e o r p u b l i s h , t h a t i n w h o l e o r

i n p a r t c o n t a i n s o r i s d e r i v e d f r o m t h e P r o g r a m o r a n y p a r t t h e r e o f , t o b e

l i c e n s e d a s a w h o l e a t n o c h a r g e t o a l l t h i r d p a r t i e s u n d e r t h e t e r m s o f t h i s

L i c e n s e .

c ) I f t h e m o d i e d p r o g r a m n o r m a l l y r e a d s c o m m a n d s i n t e r a c t i v e l y w h e n r u n ,

y o u m u s t c a u s e i t , w h e n s t a r t e d r u n n i n g f o r s u c h i n t e r a c t i v e u s e i n t h e m o s t

o r d i n a r y w a y , t o p r i n t o r d i s p l a y a n a n n o u n c e m e n t i n c l u d i n g a n a p p r o p r i a t e

c o p y r i g h t n o t i c e a n d a n o t i c e t h a t t h e r e i s n o w a r r a n t y ( o r e l s e , s a y i n g t h a t

y o u p r o v i d e a w a r r a n t y ) a n d t h a t u s e r s m a y r e d i s t r i b u t e t h e p r o g r a m u n d e r

t h e s e c o n d i t i o n s , a n d t e l l i n g t h e u s e r h o w t o v i e w a c o p y o f t h i s L i c e n s e .

( E x c e p t i o n : i f t h e P r o g r a m i t s e l f i s i n t e r a c t i v e b u t d o e s n o t n o r m a l l y p r i n t





s u c h a n a n n o u n c e m e n t , y o u r w o r k b a s e d o n t h e P r o g r a m i s n o t r e q u i r e d t o

p r i n t a n a n n o u n c e m e n t . )

T h e s e r e q u i r e m e n t s a p p l y t o t h e m o d i e d w o r k a s a w h o l e . I f i d e n t i a b l e s e c t i o n s

o f t h a t w o r k a r e n o t d e r i v e d f r o m t h e P r o g r a m , a n d c a n b e r e a s o n a b l y c o n s i d e r e d

i n d e p e n d e n t a n d s e p a r a t e w o r k s i n t h e m s e l v e s , t h e n t h i s L i c e n s e , a n d i t s t e r m s ,

d o n o t a p p l y t o t h o s e s e c t i o n s w h e n y o u d i s t r i b u t e t h e m a s s e p a r a t e w o r k s . B u t

w h e n y o u d i s t r i b u t e t h e s a m e s e c t i o n s a s p a r t o f a w h o l e w h i c h i s a w o r k b a s e d o n

t h e P r o g r a m , t h e d i s t r i b u t i o n o f t h e w h o l e m u s t b e o n t h e t e r m s o f t h i s L i c e n s e ,

w h o s e p e r m i s s i o n s f o r o t h e r l i c e n s e e s e x t e n d t o t h e e n t i r e w h o l e , a n d t h u s t o e a c h

a n d e v e r y p a r t r e g a r d l e s s o f w h o w r o t e i t .

T h u s , i t i s n o t t h e i n t e n t o f t h i s s e c t i o n t o c l a i m r i g h t s o r c o n t e s t y o u r r i g h t s t o

w o r k w r i t t e n e n t i r e l y b y y o u ; r a t h e r , t h e i n t e n t i s t o e x e r c i s e t h e r i g h t t o c o n t r o l

t h e d i s t r i b u t i o n o f d e r i v a t i v e o r c o l l e c t i v e w o r k s b a s e d o n t h e P r o g r a m .

I n a d d i t i o n , m e r e a g g r e g a t i o n o f a n o t h e r w o r k n o t b a s e d o n t h e P r o g r a m w i t h

t h e P r o g r a m ( o r w i t h a w o r k b a s e d o n t h e P r o g r a m ) o n a v o l u m e o f a s t o r a g e o r

d i s t r i b u t i o n m e d i u m d o e s n o t b r i n g t h e o t h e r w o r k u n d e r t h e s c o p e o f t h i s L i c e n s e .

3 . Y o u m a y c o p y a n d d i s t r i b u t e t h e P r o g r a m ( o r a w o r k b a s e d o n i t , u n d e r S e c t i o n

2 ) i n o b j e c t c o d e o r e x e c u t a b l e f o r m u n d e r t h e t e r m s o f S e c t i o n s 1 a n d 2 a b o v e

p r o v i d e d t h a t y o u a l s o d o o n e o f t h e f o l l o w i n g :

a ) A c c o m p a n y i t w i t h t h e c o m p l e t e c o r r e s p o n d i n g m a c h i n e - r e a d a b l e s o u r c e c o d e ,

w h i c h m u s t b e d i s t r i b u t e d u n d e r t h e t e r m s o f S e c t i o n s 1 a n d 2 a b o v e o n a

m e d i u m c u s t o m a r i l y u s e d f o r s o f t w a r e i n t e r c h a n g e ; o r ,

b ) A c c o m p a n y i t w i t h a w r i t t e n o e r , v a l i d f o r a t l e a s t t h r e e y e a r s , t o g i v e a n y

t h i r d p a r t y , f o r a c h a r g e n o m o r e t h a n y o u r c o s t o f p h y s i c a l l y p e r f o r m i n g

s o u r c e d i s t r i b u t i o n , a c o m p l e t e m a c h i n e - r e a d a b l e c o p y o f t h e c o r r e s p o n d i n g

s o u r c e c o d e , t o b e d i s t r i b u t e d u n d e r t h e t e r m s o f S e c t i o n s 1 a n d 2 a b o v e o n a

m e d i u m c u s t o m a r i l y u s e d f o r s o f t w a r e i n t e r c h a n g e ; o r ,

c ) A c c o m p a n y i t w i t h t h e i n f o r m a t i o n y o u r e c e i v e d a s t o t h e o e r t o d i s t r i b u t e

c o r r e s p o n d i n g s o u r c e c o d e . ( T h i s a l t e r n a t i v e i s a l l o w e d o n l y f o r n o n c o m -

m e r c i a l d i s t r i b u t i o n a n d o n l y i f y o u r e c e i v e d t h e p r o g r a m i n o b j e c t c o d e o r

e x e c u t a b l e f o r m w i t h s u c h a n o e r , i n a c c o r d w i t h S u b s e c t i o n b a b o v e . )

T h e s o u r c e c o d e f o r a w o r k m e a n s t h e p r e f e r r e d f o r m o f t h e w o r k f o r m a k i n g m o d -

i c a t i o n s t o i t . F o r a n e x e c u t a b l e w o r k , c o m p l e t e s o u r c e c o d e m e a n s a l l t h e s o u r c e

c o d e f o r a l l m o d u l e s i t c o n t a i n s , p l u s a n y a s s o c i a t e d i n t e r f a c e d e n i t i o n l e s , p l u s

t h e s c r i p t s u s e d t o c o n t r o l c o m p i l a t i o n a n d i n s t a l l a t i o n o f t h e e x e c u t a b l e . H o w e v e r ,

a s a s p e c i a l e x c e p t i o n , t h e s o u r c e c o d e d i s t r i b u t e d n e e d n o t i n c l u d e a n y t h i n g t h a t i s

n o r m a l l y d i s t r i b u t e d ( i n e i t h e r s o u r c e o r b i n a r y f o r m ) w i t h t h e m a j o r c o m p o n e n t s

( c o m p i l e r , k e r n e l , a n d s o o n ) o f t h e o p e r a t i n g s y s t e m o n w h i c h t h e e x e c u t a b l e r u n s ,

u n l e s s t h a t c o m p o n e n t i t s e l f a c c o m p a n i e s t h e e x e c u t a b l e .





I f d i s t r i b u t i o n o f e x e c u t a b l e o r o b j e c t c o d e i s m a d e b y o e r i n g a c c e s s t o c o p y f r o m

a d e s i g n a t e d p l a c e , t h e n o e r i n g e q u i v a l e n t a c c e s s t o c o p y t h e s o u r c e c o d e f r o m t h e

s a m e p l a c e c o u n t s a s d i s t r i b u t i o n o f t h e s o u r c e c o d e , e v e n t h o u g h t h i r d p a r t i e s a r e

n o t c o m p e l l e d t o c o p y t h e s o u r c e a l o n g w i t h t h e o b j e c t c o d e .

4 . Y o u m a y n o t c o p y , m o d i f y , s u b l i c e n s e , o r d i s t r i b u t e t h e P r o g r a m e x c e p t a s e x p r e s s l y

p r o v i d e d u n d e r t h i s L i c e n s e . A n y a t t e m p t o t h e r w i s e t o c o p y , m o d i f y , s u b l i c e n s e o r

d i s t r i b u t e t h e P r o g r a m i s v o i d , a n d w i l l a u t o m a t i c a l l y t e r m i n a t e y o u r r i g h t s u n d e r

t h i s L i c e n s e . H o w e v e r , p a r t i e s w h o h a v e r e c e i v e d c o p i e s , o r r i g h t s , f r o m y o u u n d e r

t h i s L i c e n s e w i l l n o t h a v e t h e i r l i c e n s e s t e r m i n a t e d s o l o n g a s s u c h p a r t i e s r e m a i n

i n f u l l c o m p l i a n c e .

5 . Y o u a r e n o t r e q u i r e d t o a c c e p t t h i s L i c e n s e , s i n c e y o u h a v e n o t s i g n e d i t . H o w e v e r ,

n o t h i n g e l s e g r a n t s y o u p e r m i s s i o n t o m o d i f y o r d i s t r i b u t e t h e P r o g r a m o r i t s

d e r i v a t i v e w o r k s . T h e s e a c t i o n s a r e p r o h i b i t e d b y l a w i f y o u d o n o t a c c e p t t h i s

L i c e n s e . T h e r e f o r e , b y m o d i f y i n g o r d i s t r i b u t i n g t h e P r o g r a m ( o r a n y w o r k b a s e d

o n t h e P r o g r a m ) , y o u i n d i c a t e y o u r a c c e p t a n c e o f t h i s L i c e n s e t o d o s o , a n d a l l i t s

t e r m s a n d c o n d i t i o n s f o r c o p y i n g , d i s t r i b u t i n g o r m o d i f y i n g t h e P r o g r a m o r w o r k s

b a s e d o n i t .

6 . E a c h t i m e y o u r e d i s t r i b u t e t h e P r o g r a m ( o r a n y w o r k b a s e d o n t h e P r o g r a m ) ,

t h e r e c i p i e n t a u t o m a t i c a l l y r e c e i v e s a l i c e n s e f r o m t h e o r i g i n a l l i c e n s o r t o c o p y ,

d i s t r i b u t e o r m o d i f y t h e P r o g r a m s u b j e c t t o t h e s e t e r m s a n d c o n d i t i o n s . Y o u m a y

n o t i m p o s e a n y f u r t h e r r e s t r i c t i o n s o n t h e r e c i p i e n t s ' e x e r c i s e o f t h e r i g h t s g r a n t e d

h e r e i n . Y o u a r e n o t r e s p o n s i b l e f o r e n f o r c i n g c o m p l i a n c e b y t h i r d p a r t i e s t o t h i s

L i c e n s e .

7 . I f , a s a c o n s e q u e n c e o f a c o u r t j u d g m e n t o r a l l e g a t i o n o f p a t e n t i n f r i n g e m e n t o r

f o r a n y o t h e r r e a s o n ( n o t l i m i t e d t o p a t e n t i s s u e s ) , c o n d i t i o n s a r e i m p o s e d o n y o u

( w h e t h e r b y c o u r t o r d e r , a g r e e m e n t o r o t h e r w i s e ) t h a t c o n t r a d i c t t h e c o n d i t i o n s

o f t h i s L i c e n s e , t h e y d o n o t e x c u s e y o u f r o m t h e c o n d i t i o n s o f t h i s L i c e n s e . I f y o u

c a n n o t d i s t r i b u t e s o a s t o s a t i s f y s i m u l t a n e o u s l y y o u r o b l i g a t i o n s u n d e r t h i s L i c e n s e

a n d a n y o t h e r p e r t i n e n t o b l i g a t i o n s , t h e n a s a c o n s e q u e n c e y o u m a y n o t d i s t r i b u t e

t h e P r o g r a m a t a l l . F o r e x a m p l e , i f a p a t e n t l i c e n s e w o u l d n o t p e r m i t r o y a l t y - f r e e

r e d i s t r i b u t i o n o f t h e P r o g r a m b y a l l t h o s e w h o r e c e i v e c o p i e s d i r e c t l y o r i n d i r e c t l y

t h r o u g h y o u , t h e n t h e o n l y w a y y o u c o u l d s a t i s f y b o t h i t a n d t h i s L i c e n s e w o u l d

b e t o r e f r a i n e n t i r e l y f r o m d i s t r i b u t i o n o f t h e P r o g r a m .

I f a n y p o r t i o n o f t h i s s e c t i o n i s h e l d i n v a l i d o r u n e n f o r c e a b l e u n d e r a n y p a r t i c u l a r

c i r c u m s t a n c e , t h e b a l a n c e o f t h e s e c t i o n i s i n t e n d e d t o a p p l y a n d t h e s e c t i o n a s a

w h o l e i s i n t e n d e d t o a p p l y i n o t h e r c i r c u m s t a n c e s .

I t i s n o t t h e p u r p o s e o f t h i s s e c t i o n t o i n d u c e y o u t o i n f r i n g e a n y p a t e n t s o r o t h e r

p r o p e r t y r i g h t c l a i m s o r t o c o n t e s t v a l i d i t y o f a n y s u c h c l a i m s ; t h i s s e c t i o n h a s

t h e s o l e p u r p o s e o f p r o t e c t i n g t h e i n t e g r i t y o f t h e f r e e s o f t w a r e d i s t r i b u t i o n s y s t e m ,

w h i c h i s i m p l e m e n t e d b y p u b l i c l i c e n s e p r a c t i c e s . M a n y p e o p l e h a v e m a d e g e n e r o u s

c o n t r i b u t i o n s t o t h e w i d e r a n g e o f s o f t w a r e d i s t r i b u t e d t h r o u g h t h a t s y s t e m i n





r e l i a n c e o n c o n s i s t e n t a p p l i c a t i o n o f t h a t s y s t e m ; i t i s u p t o t h e a u t h o r / d o n o r t o

d e c i d e i f h e o r s h e i s w i l l i n g t o d i s t r i b u t e s o f t w a r e t h r o u g h a n y o t h e r s y s t e m a n d a

l i c e n s e e c a n n o t i m p o s e t h a t c h o i c e .

T h i s s e c t i o n i s i n t e n d e d t o m a k e t h o r o u g h l y c l e a r w h a t i s b e l i e v e d t o b e a c o n s e -

q u e n c e o f t h e r e s t o f t h i s L i c e n s e .

8 . I f t h e d i s t r i b u t i o n a n d / o r u s e o f t h e P r o g r a m i s r e s t r i c t e d i n c e r t a i n c o u n t r i e s

e i t h e r b y p a t e n t s o r b y c o p y r i g h t e d i n t e r f a c e s , t h e o r i g i n a l c o p y r i g h t h o l d e r w h o

p l a c e s t h e P r o g r a m u n d e r t h i s L i c e n s e m a y a d d a n e x p l i c i t g e o g r a p h i c a l d i s t r i b u t i o n

l i m i t a t i o n e x c l u d i n g t h o s e c o u n t r i e s , s o t h a t d i s t r i b u t i o n i s p e r m i t t e d o n l y i n o r

a m o n g c o u n t r i e s n o t t h u s e x c l u d e d . I n s u c h c a s e , t h i s L i c e n s e i n c o r p o r a t e s t h e

l i m i t a t i o n a s i f w r i t t e n i n t h e b o d y o f t h i s L i c e n s e .

9 . T h e F r e e S o f t w a r e F o u n d a t i o n m a y p u b l i s h r e v i s e d a n d / o r n e w v e r s i o n s o f t h e

G e n e r a l P u b l i c L i c e n s e f r o m t i m e t o t i m e . S u c h n e w v e r s i o n s w i l l b e s i m i l a r i n

s p i r i t t o t h e p r e s e n t v e r s i o n , b u t m a y d i e r i n d e t a i l t o a d d r e s s n e w p r o b l e m s o r

c o n c e r n s .

E a c h v e r s i o n i s g i v e n a d i s t i n g u i s h i n g v e r s i o n n u m b e r . I f t h e P r o g r a m s p e c i e s a

v e r s i o n n u m b e r o f t h i s L i c e n s e w h i c h a p p l i e s t o i t a n d a n y l a t e r v e r s i o n , y o u h a v e

t h e o p t i o n o f f o l l o w i n g t h e t e r m s a n d c o n d i t i o n s e i t h e r o f t h a t v e r s i o n o r o f a n y

l a t e r v e r s i o n p u b l i s h e d b y t h e F r e e S o f t w a r e F o u n d a t i o n . I f t h e P r o g r a m d o e s n o t

s p e c i f y a v e r s i o n n u m b e r o f t h i s L i c e n s e , y o u m a y c h o o s e a n y v e r s i o n e v e r p u b l i s h e d

b y t h e F r e e S o f t w a r e F o u n d a t i o n .

1 0 . I f y o u w i s h t o i n c o r p o r a t e p a r t s o f t h e P r o g r a m i n t o o t h e r f r e e p r o g r a m s w h o s e

d i s t r i b u t i o n c o n d i t i o n s a r e d i e r e n t , w r i t e t o t h e a u t h o r t o a s k f o r p e r m i s s i o n . F o r

s o f t w a r e w h i c h i s c o p y r i g h t e d b y t h e F r e e S o f t w a r e F o u n d a t i o n , w r i t e t o t h e F r e e

S o f t w a r e F o u n d a t i o n ; w e s o m e t i m e s m a k e e x c e p t i o n s f o r t h i s . O u r d e c i s i o n w i l l b e

g u i d e d b y t h e t w o g o a l s o f p r e s e r v i n g t h e f r e e s t a t u s o f a l l d e r i v a t i v e s o f o u r f r e e

s o f t w a r e a n d o f p r o m o t i n g t h e s h a r i n g a n d r e u s e o f s o f t w a r e g e n e r a l l y .

N o W a r r a n t y

1 1 . B e c a u s e t h e p r o g r a m i s l i c e n s e d f r e e o f c h a r g e , t h e r e i s n o w a r r a n t y

f o r t h e p r o g r a m , t o t h e e x t e n t p e r m i t t e d b y a p p l i c a b l e l a w . E x -

c e p t w h e n o t h e r w i s e s t a t e d i n w r i t i n g t h e c o p y r i g h t h o l d e r s a n d / o r

o t h e r p a r t i e s p r o v i d e t h e p r o g r a m a s i s w i t h o u t w a r r a n t y o f a n y

k i n d , e i t h e r e x p r e s s e d o r i m p l i e d , i n c l u d i n g , b u t n o t l i m i t e d t o , t h e

i m p l i e d w a r r a n t i e s o f m e r c h a n t a b i l i t y a n d f i t n e s s f o r a p a r t i c u l a r

p u r p o s e . T h e e n t i r e r i s k a s t o t h e q u a l i t y a n d p e r f o r m a n c e o f t h e

p r o g r a m i s w i t h y o u . S h o u l d t h e p r o g r a m p r o v e d e f e c t i v e , y o u a s -

s u m e t h e c o s t o f a l l n e c e s s a r y s e r v i c i n g , r e p a i r o r c o r r e c t i o n .

1 2 . I n n o e v e n t u n l e s s r e q u i r e d b y a p p l i c a b l e l a w o r a g r e e d t o i n w r i t -

i n g w i l l a n y c o p y r i g h t h o l d e r , o r a n y o t h e r p a r t y w h o m a y m o d i f y





a n d / o r r e d i s t r i b u t e t h e p r o g r a m a s p e r m i t t e d a b o v e , b e l i a b l e t o

y o u f o r d a m a g e s , i n c l u d i n g a n y g e n e r a l , s p e c i a l , i n c i d e n t a l o r c o n -

s e q u e n t i a l d a m a g e s a r i s i n g o u t o f t h e u s e o r i n a b i l i t y t o u s e t h e

p r o g r a m ( i n c l u d i n g b u t n o t l i m i t e d t o l o s s o f d a t a o r d a t a b e i n g

r e n d e r e d i n a c c u r a t e o r l o s s e s s u s t a i n e d b y y o u o r t h i r d p a r t i e s o r a

f a i l u r e o f t h e p r o g r a m t o o p e r a t e w i t h a n y o t h e r p r o g r a m s ) , e v e n

i f s u c h h o l d e r o r o t h e r p a r t y h a s b e e n a d v i s e d o f t h e p o s s i b i l i t y o f

s u c h d a m a g e s .

E n d o f T e r m s a n d C o n d i t i o n s

A p p e n d i x : H o w t o A p p l y T h e s e T e r m s t o Y o u r N e w

P r o g r a m s

I f y o u d e v e l o p a n e w p r o g r a m , a n d y o u w a n t i t t o b e o f t h e g r e a t e s t p o s s i b l e u s e t o

t h e p u b l i c , t h e b e s t w a y t o a c h i e v e t h i s i s t o m a k e i t f r e e s o f t w a r e w h i c h e v e r y o n e c a n

r e d i s t r i b u t e a n d c h a n g e u n d e r t h e s e t e r m s .

T o d o s o , a t t a c h t h e f o l l o w i n g n o t i c e s t o t h e p r o g r a m . I t i s s a f e s t t o a t t a c h t h e m t o

t h e s t a r t o f e a c h s o u r c e l e t o m o s t e e c t i v e l y c o n v e y t h e e x c l u s i o n o f w a r r a n t y ; a n d

e a c h l e s h o u l d h a v e a t l e a s t t h e c o p y r i g h t l i n e a n d a p o i n t e r t o w h e r e t h e f u l l n o t i c e

i s f o u n d .

< o n e l i n e t o g i v e t h e p r o g r a m ' s n a m e a n d a b r i e f i d e a o f w h a t i t d o e s . >

C o p y r i g h t ( C ) < y e a r > < n a m e o f a u t h o r >

T h i s p r o g r a m i s f r e e s o f t w a r e ; y o u c a n r e d i s t r i b u t e i t a n d / o r m o d i f y i t u n -

d e r t h e t e r m s o f t h e G N U G e n e r a l P u b l i c L i c e n s e a s p u b l i s h e d b y t h e F r e e

S o f t w a r e F o u n d a t i o n ; e i t h e r v e r s i o n 2 o f t h e L i c e n s e , o r ( a t y o u r o p t i o n ) a n y

l a t e r v e r s i o n .

T h i s p r o g r a m i s d i s t r i b u t e d i n t h e h o p e t h a t i t w i l l b e u s e f u l , b u t W I T H O U T

A N Y W A R R A N T Y ; w i t h o u t e v e n t h e i m p l i e d w a r r a n t y o f M E R C H A N T A B I L -

I T Y o r F I T N E S S F O R A P A R T I C U L A R P U R P O S E . S e e t h e G N U G e n e r a l

P u b l i c L i c e n s e f o r m o r e d e t a i l s .

Y o u s h o u l d h a v e r e c e i v e d a c o p y o f t h e G N U G e n e r a l P u b l i c L i c e n s e a l o n g

w i t h t h i s p r o g r a m ; i f n o t , w r i t e t o t h e F r e e S o f t w a r e F o u n d a t i o n , I n c . , 5 1

F r a n k l i n S t r e e t , F i f t h F l o o r , B o s t o n , M A 0 2 1 1 0 - 1 3 0 1 , U S A

A l s o a d d i n f o r m a t i o n o n h o w t o c o n t a c t y o u b y e l e c t r o n i c a n d p a p e r m a i l .

I f t h e p r o g r a m i s i n t e r a c t i v e , m a k e i t o u t p u t a s h o r t n o t i c e l i k e t h i s w h e n i t s t a r t s i n

a n i n t e r a c t i v e m o d e :





G n o m o v i s i o n v e r s i o n 6 9 , C o p y r i g h t ( C ) < y e a r > < n a m e o f a u t h o r >

G n o m o v i s i o n c o m e s w i t h A B S O L U T E L Y N O W A R R A N T Y ; f o r d e t a i l s t y p e

` s h o w w ' .

T h i s i s f r e e s o f t w a r e , a n d y o u a r e w e l c o m e t o r e d i s t r i b u t e i t u n d e r c e r t a i n

c o n d i t i o n s ; t y p e ` s h o w c ' f o r d e t a i l s .

T h e h y p o t h e t i c a l c o m m a n d s s h o w w a n d s h o w c s h o u l d s h o w t h e a p p r o p r i a t e p a r t s o f

t h e G e n e r a l P u b l i c L i c e n s e . O f c o u r s e , t h e c o m m a n d s y o u u s e m a y b e c a l l e d s o m e t h i n g

o t h e r t h a n s h o w w a n d s h o w c ; t h e y c o u l d e v e n b e m o u s e - c l i c k s o r m e n u i t e m s w h a t e v e r

s u i t s y o u r p r o g r a m .

Y o u s h o u l d a l s o g e t y o u r e m p l o y e r ( i f y o u w o r k a s a p r o g r a m m e r ) o r y o u r s c h o o l , i f

a n y , t o s i g n a c o p y r i g h t d i s c l a i m e r f o r t h e p r o g r a m , i f n e c e s s a r y . H e r e i s a s a m p l e ; a l t e r

rockbox-gigabeatfx

Documents