package0xxxx z z jיv X i ibook 1 9 9 7 - 9 9 . S . W e y e r , G . S i m o n . A l l R i g h t s R e s e r v e d W o r l d w i d e a d v a p i . h t m NewtPack 3.4 1995-98, S. Weyer (portions may be derived from Newton Toolkit 1992-95, Apple Computer, Inc.)book A i C j A @ UR+book @ URC[labels TC ! q A
y d d e XA y 1 Q q ! A Y @ UR/vversion @ URflags @ URiISBN @ URtitle @ URSshortTitle @ UR3 {author @ UR
hcopyright @ UR-publisher @ UR@publicationDate @ URI data @ UR !styles @ URjɿ~contents @ URbrowsers @ URߧwtemplates @ UR0.rendering @ URu?appSymbol @ UR\7icon @ URohints "@ a d v a p i . h t m @ UR_string .@ N e w t ' s C a p e : A P I @ N C A P I <@ S t e v e W e y e r , G r e g S i m o n @ 1 9 9 7 - 9 9 . S . W e y e r , G . S i m o n . A l l R i g h t s R e s e r v e d W o r l d w i d e $@ S t e v e W e y e r $C ! (A A a @ UR form_hidden @ URUBform_printnames @ URh base_href @ URn9links @ URJqGetUserConfig @ URedata C A C @ h t t p : / / m e m b e r s . b e l l a t l a n t i c . n e t / ~ s w e y e r / n e w t o n / n e w t s c a p e / d o c s / a d v a p i . h t m A @ URArray C $A 1 I i @ UR% Fclass @ UR:instructions @ UR`literals @ UR@argFrame @ UR[<;numArgs @ UR?(CodeBlock @ I(|o ({|A A i ! 9 a @ URGetRoot $@ UR&!NewtsCape:NewtsCape @ URX[GetGlobals C
Y $A
!
A @ UR _nextArgFrame @ UR_parent @ URU{y_implementor @ URߧwconfigSym @ URapp C
q A
@A A @ @ @ c@ @ A 1 a I Q Q 1 ! !9 ! " # $ $9 $ %Y % & ' ' (9 ( ) ) * * + - .1 . . / / 09 0 1 1 1 2 3i 3 4 4 4 5 6 6 6 7 8! 8 9Q 9 :q >q > ?Q ? ? @ A9 B B C Da E E F J L) Lq M M N O1 O Pa U9 U YI [A [ _ a9 a di eY e f h hA h i) jq ka l m m n o! oa p1 q! q r s t u vA v w w x y z {! | | }9 ~i ~ 9 ! Q 9 ! y a Y A 1 q ) q 1 Y 9 y i Y Y ! I I I A Y 9 1 q I a 9 a ƹ lj y q ˁ 9 y Ω 9 Y Љ 9 q I ҙ i ԩ i չ q 1 ۩ ) y q ݡ ) y 1 9 ! a 1 ! Y 9 Q ! q ! ) 9 y Y C 9 A i A q ! @ UR㧦bviewFont @ URiname ,@ N e w t ' s C a p e A P I @ T o p C i A q @ T h i s d o c u m e n t d e s c r i b e s N e w t ' s C a p e ' s i n t e r f a c e w i t h o t h e r a p p l i c a t i o n s : b o t h h o w i t m a k e s u s e o f o t h e r a p p l i c a t i o n s , a n d a l s o h o w i t c a n b e u s e d b y o t h e r a p p l i c a t i o n s v i a i t s A P I ( a p p l i c a t i o n p r o g r a m i n t e r f a c e ) . 4A l C @ A q \@ N e w t ' s C a p e ' s U s e o f O t h e r A p p l i c a t i o n s C I @ G e n e r a l l y , t h e s i t u a t i o n s d e s c r i b e d b e l o w a r e i n i t i a t e d i n N e w t ' s C a p e . C @ @ N o t e s C 1 @ *@ i n N e w t ' s C a p e C @ q A q @ URazǸhrefs @ UR'vscripts ,@ F i l e : O p e n N o t e s A (A 9 < 8 2@ u s e r i n t f . h t m # N o t e s A "@ UR!viewgesturescript C @ I{|; A i @ UR PhrefScript C 9 $A
a y @ URX'@unit @ UR9:LgestureID C
q C 0@ r e a d s H T M L s o u r c e C @ a q H@ F i l e : S a v e H T M L / I m a g e t o N o t e s A q (A t 8 B@ u s e r i n t f . h t m # S a v e H T M L N o t e s C P@ c o p i e s c a c h e d H T M L / I m a g e t o N o t e s C i q A q :@ < L I N K H R E F = " N o t e s / . . . > $A @ @ D @ A (A ) x 8 (@ h e a d . h t m # L I N K C i T@ i n c l u d e s s o u r c e i n a n o t h e r d o c u m e n t C i A q 8@ < F O R M A C T I O N = " N o t e s " > $A @ @ $ @ A Q (A y P 8 2@ b o d y a g t . h t m # A C T I O N C @@ w r i t e s f o r m d a t a t o N o t e s C )@ i q @@ B o o k m a r k s : S a v e a s O u t l i n e A y (A d 8 >@ u s e r i n t f . h t m # S a v e O u t l i n e C @ s a v e s b o o k m a r k s ( U R L s a n d t i t l e s ) t o a N o t e s o u t l i n e f o r a c c e s s ( g e t U R L ) o r e d i t i n g / i m p o r t ( i f H T M L i s t i n s t a l l e d ) C i ) I q @ i n N o t e s A @ @ A Y (A 4 8 D@ u s e r i n t f . h t m # N o t e s N e w t w o r k s C @ p@ [ t e x t c o n t a i n s < H T M L > . . . < T I T L E > ] N e w t ' s C a p e : O p e n C i 0@ r e a d s H T M L s o u r c e C @ ~@ [ h t t p : / m a i l t o : / n e w s : U R L h i g h l i g h t e d ] N e w t ' s C a p e : g e t U R L C I V@ g e t s H T M L d o c u m e n t f r o m c a c h e o r n e t C @ d@ [ 2 . x . o t h e r t e x t s e l e c t e d ] N e w t ' s C a p e : F i n d C i A q T@ p e r f o r m s q u e r y ( s e e F i n d . T i t l e e t c . $A P ( A (A P ( 0 :@ u s e r i n t f . h t m # F i n d T i t l e C !Q @ @ [ i n o u t l i n e o r c h e c k l i s t s t a t i o n e r y , H T M L i s t i n s t a l l e d ] E x p o r t t o H T M L C " @ g e n e r a t e s H T M L s o u r c e i n s e p a r a t e n o t e ( t o b e v i e w e d v i a N e w t ' s C a p e : O p e n ) C " @ @ [ i n o u t l i n e o r c h e c k l i s t s t a t i o n e r y , H T M L i s t i n s t a l l e d ; i t e m s c o n t a i n U R L s ] N e w t ' s C a p e : A d d B o o k m a r k s C # H@ a d d s b o o k m a r k s t o N e w t ' s C a p e C $ @ @ N e w t W o r k s C $Q @ *@ i n N e w t ' s C a p e C $@ $ q 4@ F i l e : O p e n N e w t W o r k s A $ (A % L 8 B@ u s e r i n t f . h t m # O p e n N e w t W o r k s C %q 0@ r e a d s H T M L s o u r c e C %@ & q P@ F i l e : S a v e H T M L / I m a g e t o N e w t W o r k s A &! (A &I 8 J@ u s e r i n t f . h t m # S a v e H T M L N e w t w o r k s C & X@ c o p i e s c a c h e d H T M L / I m a g e t o N e w t W o r k s C i ') 'Q 'q q &@ i n N e w t W o r k s A @ $@ A ' (A $ 4 < 8 C ' @ r@ [ t e x t c o n t a i n s < H T M L > . . . < T I T L E > ] T o o l s : N e w t ' s C a p e C (Q 0@ r e a d s H T M L s o u r c e C ( @ |@ [ h t t p : / m a i l t o : / n e w s : U R L h i g h l i g h t e d ] T o o l s : N e w t ' s C a p e C )1 V@ g e t s H T M L d o c u m e n t f r o m c a c h e o r n e t C ) @ \@ [ o t h e r t e x t s e l e c t e d ] T o o l s : N e w t ' s C a p e C i *! *y * q T@ p e r f o r m s q u e r y ( s e e F i n d . T i t l e e t c . $A P ( A * (A P ( 0 C *@ + q @ N a m e s A +! (A +I D 2@ u s e r i n t f . h t m # N a m e s C + @ S i m i l a r t o N o t e p a d a n d N e w t W o r k s , p r o c e s s a U R L ( : g e t U R L ) t h a t i s i n a c u s t o m " U R L " f i e l d , o r i n t h e N o t e s f i e l d o f N a m e s ( i t i g n o r e s a n y < ! - - H T M L c o m m e n t s - - > i n N o t e s ) , o r p r o c e s s a s h o r t H T M L s o u r c e d o c u m e n t ( : O p e n ) i n N o t e s f i e l d . C -@ - q @ P a p e r b a c k A - (A - $ D 8@ o t h a p p r . h t m # P a p e r b a c k C .I @ 4@ F i l e : O p e n P a p e r b a c k C . 0@ r e a d s H T M L s o u r c e C . @ N o t e : F i l e : O p e n W a b u m i U n i ( a P a p e r b a c k - l i k e a p p l i c a t i o n ) i s a v a i l a b l e i n t h e J a p a n e s e v e r s i o n . C / @ &@ I n b o x / O u t b o x C 0 @ ,@ F i l e : O p e n I n b o x C 0Q @ j@ r e a d s H T M L s o u r c e f r o m e m a i l o r b e a m e d e n t r i e s C 0 @ 4@ t a p o n m a i l t o : l i n k C 1) p@ m s g g o e s i n t o O u t b o x u s i n g d e f a u l t m a i l t r a n s p o r t C 1 @ H@ t a p o n h t t p : l i n k ( i f n o N I E ) C 2 @ m s g t o " W e b M a i l p r o x y " g o e s i n t o O u t b o x u s i n g d e f a u l t m a i l t r a n s p o r t C 2@ 2 q &@ N e w t ' s P a p e r A 3 (A 3) 0 D <@ o t h t o o l s . h t m # N e w t s P a p e r C 3 @ 0@ t a p o n n e w s : l i n k C 3 H@ U R L i s p a s s e d t o N e w t ' s P a p e r C 4) @ ^@ [ i n N e w t ' s P a p e r , h t t p : U R L e n c o u n t e r e d ] C 4 2@ N e w t ' s C a p e : g e t U R L C 4@ 5) q 0@ B o o k m a r k M a n a g e r s A 59 (A 5a D D 6@ o t h t o o l s . h t m # B o o k M g r C 5 N@ " a c c e s s b o o k m a r k s o u p s d i r e c t l y C 6 h@ " I m p o r t / E x p o r t b o o k m a r k s f r o m / t o N e w t ' s C a p e C 6 R@ " a c c e s s h t t p : U R L v i a N e w t ' s C a p e C 7@ 71 q @ H y p e r N e w t A 7A (A 7i $ D 4@ h t t p : / / w w w . t o w . c o m / C 7 @ d@ i n a b o o k ' s a c t i o n b u t t o n , s e l e c t H y p e r L i n k C 89 @ s a v e s a l i n k / b o o k m a r k t o t h e c u r r e n t d o c u m e n t ( U R L , i s b n a n d p a g e n u m b e r ) C 8 @ \@ i n H y p e r N e w t , s e l e c t a N e w t ' s C a p e l i n k C 9i r@ o p e n s b o o k ( p a c k a g e ) o r H T M L s o u r c e ( c a c h e o r w e b ) C 9 @ :I L@ : o p e n N e w t l e t ( v i e w B o u n d s , p a r a m s ) $@ o p e n N e w t l e t C i : =i = q @ N o r m a l l y , a n e w t l e t ' s ( a N e w t o n a p p l i c a t i o n A P P L E T ) v i e w B o u n d s a n d o t h e r p a r a m e t e r s ( v i a P A R A M ) a r e s e t d i r e c t l y b e f o r e N e w t ' s C a p e c a l l s : o p e n ( ) . I f y o u d o n ' t l i k e t h e i d e a o f a n o t h e r a p p l i c a t i o n m e s s i n g a r o u n d w i t h y o u r v i e w B o u n d s a n d o t h e r s l o t s , y o u r n e w t l e t c a n p r o v i d e a n o p e n N e w t l e t m e t h o d w h i c h i n i t i a l i z e s i t s e l f b a s e d o n t h e f o l l o w i n g p a r a m e t e r s : 4A A = > (A = 0 ` 2@ b o d y a g t . h t m # A P P L E T (A >A d d ` 0@ b o d y a g t . h t m # P A R A M C > @ 2@ v i e w B o u n d s [ f r a m e ] C > v@ v i e w B o u n d s i n r e l a t i v e c o o r d i n a t e s f o r t h e b o o k p a g e C ?i @ *@ p a r a m s [ f r a m e ] C ? :@ P A R A M s l o t s a n d v a l u e s C @ @ @i \@ N e w t ' s C a p e ' s U s e b y O t h e r A p p l i c a t i o n s @ A P I C @ @ O t h e r a p p l i c a t i o n s c a n c a l l t h e f o l l o w i n g m e t h o d s i n N e w t ' s C a p e ' s A P I . C i AY A A q *@ " d i s p a t c h F i l e A 0 A A (A A 0 $ , 0 (@ # d i s p a t c h F i l e C i B) BQ Bq q "@ " f e t c h U R L A A B (A B $ 0 @ # f e t c h U R L C i B C C9 q ,@ " G e t P i c t A s B i t s A 4 A CI (A Cq 4 $ @ 0 *@ # G e t P i c t A s B i t s C i C C D q "@ " G e t S o u n d A A D (A DA $ 0 @ # G e t S o u n d C i D D D q @ " g e t U R L A A D (A D $ 0 @ # g e t U R L C i E9 Eq E q 2@ " i n s t a l l H e l p e r A p p A @ A E (A E @ $ 0 0@ # i n s t a l l H e l p e r A p p C i F FI Fi q .@ " i n s t a l l H T M L A p p A 8 A Fy (A F 8 $ 0 ,@ # i n s t a l l H T M L A p p C i F I Ii q (@ g e t U R L a n d f e t c h U R L a r e s i m i l a r t o a p r o p o s e d s t a n d a r d b y F l a s h S h e r i d a n b u t i m p l e m e n t d i f f e r e n t o p t i o n s . T h e d e t a i l s b e l o w w i l l c h a n g e f r o m u s e r a n d d e v e l o p e r f e e d b a c k . N e e d s w o r k i n a r e a o f e r r o r f e e d b a c k . T h e r e a r e n u m e r o u s e x a m p l e s - - s e e t h e r e g u l a r E x a m p l e s p a g e . LA H D T A I I J J (A I 0 @ # g e t U R L (A I , 0 @ # f e t c h U R L (A JA D 0 ` T@ h t t p : / / p o b o x . c o m / ~ f l a s h e r i d n / u r l c o p (A J T P ,@ . . / e x a m p l e s . h t m C i K K K q @ T h e h e l p u r l e x a m p l e ( N T K a n d N e w t D e v E n v f o r m a t s ) p r o v i d e s $A T A K (A K T < 0 2@ . . / h e l p u r l . s i t . h q x C LA @ *@ p r o t o A b o u t T e x t C i L MA Ma q @ r e c o g n i z e s a n d r e f o r m a t s < A H R E F = " m a i l t o : / h t t p : . . . " > r e f e r e n c e s a n d u s e s : g e t U R L A $ A Mq (A D $ ` C M @ 2@ d y n a m i c h e l p b o o k s C i N Ni N q \@ u s i n g : d i s p a t c h F i l e o n H T M L h e l p s o u r c e $A 4 P A N (A A 4 0 C N @ N@ E x t e n d i n g P r o t o c o l s , F i l e s , H T M L C OI @ Y o u c a n e x t e n d / m o d i f y h o w N e w t ' s C a p e p r o c e s s e s U R L s a n d f i l e s i n s e v e r a l w a y s . C P @ P@ P r o t o c o l s ( N I E a p p s ) , e . g . , h t t p : C i P Sa S q @ W h e n N e w t ' s C a p e p r o c e s s e s a U R L , i t c h e c k s w i t h u r l C o p w h e t h e r a n a p p l i c a t i o n i s r e g i s t e r e d f o r t h a t t y p e . T o i n c l u d e s u p p o r t f o r f t p : , m a i l t o : o r o t h e r i n t e r n e t p r o t o c o l s , j u s t m a k e s u r e t h a t y o u r a p p l i c a t i o n r e g i s t e r s w i t h u r l C o p . B y d e f a u l t , N e w t ' s C a p e r e g i s t e r s f o r h t t p , b u t d i s p a t c h e s o n h t t p : , m a i l t o : a n d n e w s : U R L s e v e n i f u r l C o p i s n o t i n s t a l l e d . TA A S TY T T (A T 0 ` T@ h t t p : / / p o b o x . c o m / ~ f l a s h e r i d n / u r l c o p (A T 4 P @ # h t t p U R L (A T P H "@ # m a i l t o U R L (A U P , @ # n e w s U R L C UQ @ U V@ F i l e s ( h e l p e r a p p s ) , e . g . , t e x t / h t m l "@ h e l p e r A p p s C U Z@ N e w t ' s C a p e c o m p l e t e s t h e t r a n s f e r o f a t e x t o r b i n a r y f i l e v i a h t t p : i f a " h e l p e r A p p " i s r e g i s t e r e d w i t h N e w t ' s C a p e f o r t h a t m e d i a / M I M E t y p e , e . g . , t e x t / p l a i n ( a n d p o s s i b l y f o r s p e c i f i c f i l e e x t e n s i o n s f o r t h a t t y p e ) . T h e h e l p e r A p p r e c e i v e s t h e e n t i r e f i l e . B y d e f a u l t , N e w t ' s C a p e h a n d l e s h t t p t y p e s : t e x t / h t m l , i m a g e / g i f , x - n e w t o n - c o m p a t i b l e - p k g , a n d t e x t / p l a i n . I t a l s o h a n d l e s i m a g e / j p e g i f J P E G p l u g i n i s i n s t a l l e d . C i Yi ZA Zy q @ Y o u c a n i n s t a l l a h e l p e r A p p s o t h a t i t i s a l w a y s a v a i l a b l e ; o r s p e c i f y i t a s a n o p t i o n f o r : g e t U R L . 4A 4 A Z Z (A Z H 0 0@ # i n s t a l l H e l p e r A p p (A [ @ 0 ` .@ # h e l p e r A p p O p t i o n C [Y @ [ `@ H T M L t a g s ( H T M L a p p s ) , e . g . , v i e w i n g t a g s @ h t m l A p p s C [ @ W h i l e p a r s i n g a n H T M L d o c u m e n t , N e w t ' s C a p e p a s s e s t h e r e s u l t s t o t h e c u r r e n t " h t m l A p p " . T h e h t m l A p p r e c e i v e s a p a r s e d r e p r e s e n t a t i o n o f t h e f i l e ( n o t r a w H T M L ) , a n d i m p l e m e n t s a s u b s e t o f t a g s , f o r e x a m p l e , t o d i s p l a y t h e i n f o r m a t i o n v i a a " b r o w s e r " o r a d d d a t a t o a s o u p o r o t h e r a p p l i c a t i o n . B y d e f a u l t , N e w t ' s C a p e d i s p l a y s H T M L a s a N e w t o n b o o k o r s a v e s i t d i r e c t l y a s a p a c k a g e . C i _! `9 `q q @ Y o u c a n i n s t a l l a n h t m l A p p s o t h a t i t i s a v a i l a b l e t o t h e u s e r i n t h e P r o c e s s p i c k e r m e n u ; o r s p e c i f y i t a s a n o p t i o n f o r : g e t U R L . 4A 4 A ` ` (A ` H 0 ,@ # i n s t a l l H T M L A p p (A a $ ` *@ # h t m l A p p O p t i o n C aQ @ aq @ o p t i o n s @ o p t i o n s C a @ S e v e r a l m e t h o d s ( d i s p a t c h F i l e , f e t c h U R L , g e t U R L ) u s e a n o p t i o n s f r a m e . V a l u e s w i l l d e f a u l t t o u s e r p r e f e r e n c e s / s e t t i n g s w h e r e a p p l i c a b l e ( t h e s e h a v e l i n k s b e l o w ) . I t c a n c u r r e n t l y c o n t a i n t h e f o l l o w i n g s l o t s ( t h e s e m i g h t c h a n g e , a n d t h e r e a r e m o r e t h a n d o c u m e n t e d h e r e ; p l e a s e l e t u s k n o w i f y o u s t a r t t o r e l y o n t h e m o r w o u l d l i k e m o r e i n f o ) : C i d d d q 6@ a g e n t P r e f i x [ s t r i n g ] A ,@ $ @ A d (A e , 8 >@ u s e r i n t f . h t m # A g e n t P r e f i x C eq f@ s t r i n g t o p r e f i x t o U s e r - A g e n t r e q u e s t f i e l d C i e fA fa q F@ a g e n t S i z e R e s [ s t r i n g o r n i l ] A 0@ @ @ A fq (A f 0 ( 8 @@ u s e r i n t f . h t m # A g e n t S i z e R e s C f @ t h i s m i g h t b e u s e d b y a p r o x y s e r v e r t h a t a u t o m a t i c a l l y c o n v e r t e d g r a p h i c s , f o r e x a m p l e . i f n o n - e m p t y s t r i n g , s u p p l y h e a d e r f i e l d s : C h! @ @ U A - c o l o r C hY @ w i t h v a l u e ( b a s e d o n b i t s P e r P i x e l p r e f e r e n c e ) : m o n o 1 , m o n o 4 , m o n o 1 6 C i @ @ U A - p i x e l s C iA 0@ w i t h v a l u e ( b a s e d o n p a g e s i z e , a n d r o t a t i o n f o r f u l l ) : 2 0 6 x 2 1 6 ( h e l p ) , 2 4 0 x 3 2 0 ( p o r t r a i t ) , 3 2 0 x 2 4 0 ( l a n d s c a p e ) , c u r r e n t S c r e e n W i d t h & H e i g h t ( f u l l ) C i j j j q 4@ a u t o L o g i n [ b o o l e a n ] A $@ ( @ A j (A k! $ 8 :@ u s e r i n t f . h t m # A u t o L o g i n C ky D@ a u t o m a t i c a l l y c o n n e c t ( i . e . , d i a l ) w i t h o u t p r o m p t i n g u s e r t o c o n f i r m s e t u p . t h i s m i g h t b e u s e d b y a n a g e n t t h a t a u t o m a t i c a l l y c h e c k e d / d o w n l o a d e d w e b p a g e s . C l @ (@ b a s e [ s t r i n g ] C m @ u r l . n o r m a l l y s e t a u t o m a t i c a l l y w h e n i n v o k e d v i a : g e t U R L o r w i t h s o u r c e f r a m e C i m n! nA q :@ b i t s P e r P i x e l [ i n t e g e r ] A 0@ ( @ A nQ (A ny 0 8 <@ u s e r i n t f . h t m # G r a y L e v e l s C n P@ 1 = B & W , 2 = 4 - g r a y ; , 4 = 1 6 - g r a y C o9 @ (@ b o d y [ s t r i n g ] C oy @ f o r m a i l t o : , e m a i l t e x t m e s s a g e . d e f a u l t : " I s a w t h i s c o o l d o c u m e n t i n N e w t ' s C a p e " C i pQ p p q 2@ c a c h e H T M L [ s t r i n g ] A $@ $ @ A p (A p $ 8 :@ u s e r i n t f . h t m # C a c h e H T M L C q9 @ a s o u p N a m e t o s t o r e a n H T M L d o c u m e n t . ( d e f a u l t : H T M L C a c h e : N e w t s C a p e u n l e s s " n o c a c h e " ) . C i r rQ rq q 6@ c a c h e I m a g e s [ s t r i n g ] A ,@ $ @ A r (A r , $ 8 >@ u s e r i n t f . h t m # C a c h e I m a g e s C s @ a s o u p N a m e t o s t o r e a b i t m a p o b j e c t o r r a w G I F ( r a w I m a g e ) . ( d e f a u l t : I m a g e C a c h e : N e w t s C a p e u n l e s s " n o c a c h e " ) . C i t tA ta q 4@ c a c h e O n l y [ b o o l e a n ] A $@ ( @ A tq (A t $ 8 :@ u s e r i n t f . h t m # C a c h e O n l y C t @ s t o r e b u t d o n o t d i s p l a y t e x t o r i m a g e s . ( s a m e a s p r o c e s s O p t i o n = 4 ) . n o t e : t o p r e v e n t G I F s f r o m b e i n g c o n v e r t e d , u s e r a w I m a g e C v @ ,@ c o o k i e s [ a r r a y ] C vY <@ ( t o b e d e s c r i b e d l a t e r ) C i v v w q <@ c o o k i e s C o n f i r m [ s y m b o l ] A 8@ $ @ A w) (A wQ 8 \ 8 6@ u s e r i n t f . h t m # C o o k i e s C w 2@ ' s k i p , ' a s k , ' k e e p C w @ &@ d a t a [ f r a m e ] C x1 @ f r a m e o f d a t a t o b e U R L e n c o d e d a n d s e n t ( m e t h o d : G E T / P O S T ) t o s e r v e r . d e f a u l t p r i n t o r d e r i s u n d e f i n e d , a n d i n t e r n a l p r i n t n a m e s o f s l o t s a r e u s e d a s f i e l d s u n l e s s a d a t a N a m e s a r r a y i s s u p p l i e d . C y @ 0@ d a t a N a m e s [ a r r a y ] C z) @ o p t i o n a l a r r a y o f s t r i n g s t o d e f i n e f i e l d o r d e r a n d e x a c t p r i n t n a m e s ( c a s e m a y d i f f e r f r o m i n t e r n a l s l o t p r i n t n a m e ) C i {A {y { q 8@ d o c D o n e S o u n d [ s y m b o l ] A 0@ $ @ A { (A { 0 L 8 @@ u s e r i n t f . h t m # D o c D o n e S o u n d C |) @ n i l f o r n o s o u n d . o r s y m b o l i n R O M _ s o u n d o f f ( s i m p l e B e e p , w a k e u p B e e p , p l i n k B e e p , f u n B e e p ) C } @ 4@ e x t r a H e a d e r [ f r a m e ] C }Q @ a d d i t i o n a l h e a d e r f i e l d s : n a m e s ( s l o t s y m b o l s ) a n d v a l u e s ( s t r i n g s ) f o r a n h t t p r e q u e s t , e . g . , { | X - F o o | : " 3 7 " , B a r : " x " } , w o u l d a d d : C ~ .@ X - F o o : 3 7
B a r : x C ~ ~ y q $A q ! ~@ h e l p e r A p p [ f r a m e , s y m b o l o r n i l ] ( r e q u i r e d f o r f e t c h U R L ) $A @ @ @ ,@ h e l p e r A p p O p t i o n A (A B 0 8 p C ! @ @ n i l C Q <@ d e f a u l t s t o N e w t ' s C a p e C @ @ s y m b o l C i q @ r e f e r s t o a n i n s t a l l e d a p p l i c a t i o n ( h e l p e r A p p ) t h a t i m p l e m e n t s a d d F i l e . $A A (A 0 ( ` @ # a d d F i l e C )@ A q @ f r a m e A Q (A y 8 "@ # h e l p e r A p p C @ :@ h t m l A p p [ f r a m e o r n i l ] (@ h t m l A p p O p t i o n C 9 @ @ n i l C i >@ d e f a u l t s t o N e w t ' s C a p e . C @ q @ f r a m e A (A 8 @ # h t m l A p p C i Y q 6@ h t t p N o P r o x y [ s t r i n g ] A ,@ $ @ A (A , $ 8 4@ u s e r i n t f . h t m # E x c e p t C 9 V@ p r o v i d e e x c e p t i o n s t o c u r r e n t p r o x y . C i q 2@ h t t p P r o x y [ s t r i n g ] A $@ $ @ A (A A $ 8 2@ u s e r i n t f . h t m # P r o x y C H@ s p e c i f y a p r o x y f o r t h i s U R L . C @ (@ i c o n [ b i t m a p ] C 1 @ d e f a u l t : N e w t ' s C a p e . s m a l l i c o n t o u s e i n f o r N I E s t a t u s b o x C @ 6@ I n e t S t a t u s [ b o o l e a n ] C ! @ d e f a u l t : t r u e . d i s p l a y N I E m e s s a g e s ( s t a t u s o f c o n n e c t i o n , t r a n s f e r ) C i 1 q 6@ l o a d I m a g e s [ b o o l e a n ] A (@ ( @ A A (A i ( 8 <@ u s e r i n t f . h t m # L o a d I m a g e s C @ d e f a u l t : n i l . i f t r u e , l o a d s a n y i m a g e s , t h e n r e - p r o c e s s e s m a i n d o c u m e n t C y @ h@ m e t h o d [ s t r i n g : " G E T " , " P O S T " , " H E A D " , " P U T " ? ] C @ @ m a i l t o : C 1 (@ p o s t s m e s s a g e C q @ @ h t t p : G E T C R@ U R L e n c o d e d d a t a i s a p p e n d e d t o U R L C @ "@ h t t p : P O S T C Y v@ d a t a i s p o s t e d t o s e r v e r a s a s e p a r a t e t e x t d o c u m e n t C H@ s e e d a t a , d a t a N a m e s , : g e t U R L . C I @ (@ n a m e [ s t r i n g ] C *@ f o r m a i l t o : , e m a i l a d d r e s s e e n a m e , e . g . , " f i r s t l a s t " . d e f a u l t : n a m e o f e x i s t i n g p e r s o n i n N a m e s ( m a t c h i n g e m a i l a d d r e s s ) o r h i g h l i g h t e d t e x t . C @ 0@ n o D e l a y [ b o o l e a n ] C n@ d e f a u l t : n i l . i f t r u e , n o p a u s i n g ( n o r m a l l y , N e w t ' s C a p e p a u s e s a f t e r e a c h l i n e w h i l e p a r s i n g a c o m p l e t e s t r i n g ( N o t e , c a c h e d f i l e ) , e . g . , f o r u s e r e v e n t s a n d s t a t u s u p d a t i n g ) . C @ 2@ n o S t a t u s [ b o o l e a n ] C 8@ d e f a u l t : n i l . i f t r u e ( a n d N e w t ' s C a p e i s n o t a l r e a d y o p e n ) , n o s t a t u s i n f o i s d i s p l a y e d d u r i n g p r o c e s s i n g ( t h i s i s s e p a r a t e f o r n o w f r o m I n e t S t a t u s ) C A @ .@ n o S t o p [ b o o l e a n ] C V@ d e f a u l t N I L . i f t r u e , d o n o t t e r m i n a t e p r o c e s s i n g w h e n e n c o u n t e r i n g e n d o f s t r i n g ( u s e f u l f o r m e r g i n g m u l t i p l e s o u r c e s i n t o o n e d o c u m e n t ) . < / H T M L > s t i l l t e r m i n a t e s . C @ 6@ p a g e H e i g h t [ i n t e g e r ] C I @ b o o k p a g e h e i g h t i n p i x e l s . N e w t ' s C a p e c h e c k s t h a t i t ' s a n i n t e g e r , b u t o t h e r w i s e d o e s n o b o u n d s c h e c k i n g . a d d i t i o n a l b o o k b a r b u t t o n s m a y n o t a p p e a r i n c o r r e c t l o c a t i o n s . ( s e e p a g e W i d t h ) g e n e r a l l y , y o u ' d u s e p a g e S i z e r a t h e r t h a n c r e a t e a c u s t o m p a g e s i z e . C i y q 0@ p a g e S i z e [ s y m b o l ] A @ $ @ A (A 8 8@ u s e r i n t f . h t m # P a g e S i z e C Q T@ ' h e l p , ' p o r t r a i t , ' l a n d s c a p e , ' f u l l C @ 4@ p a g e W i d t h [ i n t e g e r ] C d@ b o o k p a g e w i d t h i n p i x e l s . ( s e e p a g e H e i g h t ) C i q <@ p r o c e s s O p t i o n [ i n t e g e r ] A 4@ ( @ A (A 1 4 @ 8 6@ u s e r i n t f . h t m # P r o c e s s C i q q @ c o r r e s p o n d s t o i n i t i a l 5 P r o c e s s p i c k e r v a l u e s : 0 = D i s p l a y I t e m , 1 = D i s p l a y P a g e , 2 = D i s p l a y P a g e 1 , 3 = D i s p l a y A l l , 4 = C a c h e O n l y ( 2 . x ) , 5 = S a v e P a c k a g e ( N e w t P a c k ) . d e f a u l t : p r e v i o u s p i c k e r v a l u e o r D i s p l a y P a g e . f o r o t h e r o p t i o n s , u s e h t m l A p p A A (A P *@ # h t m l A p p O p t i o n C i Q q q 2@ r a w I m a g e [ b o o l e a n ] A @ ( @ A (A 8 8@ u s e r i n t f . h t m # r a w I m a g e C `@ i f t r u e , k e e p o r i g i n a l G I F ( o r o t h e r t y p e ) i m a g e s r a t h e r t h a n c o n v e r t i n t o N e w t o n f o r m a t . g e n e r a l l y y o u p r o b a b l y d o n o t w a n t t o u s e t h i s s i n c e t h e r a w d a t a i s c a c h e d a n d m u s t b e c o n v e r t e d e a c h t i m e i t i s u s e d . i t m a y b e u s e f u l f o r e x p e r i m e n t i n g w i t h d i f f e r e n t n u m b e r s o f g r a y s , o r t h r e s h o l d l e v e l . C i y q >@ r e m o v e C o m m e n t s [ b o o l e a n ] A 8@ ( @ A (A 8 8 D@ u s e r i n t f . h t m # r e m o v e C o m m e n t s C q @ i f t r u e , r e m o v e s < ! - - c o m m e n t s t r i n g s f r o m s o u r c e b e f o r e c a c h i n g o r p a r s i n g - - > C i A y q 6@ s t a n d A l o n e [ b o o l e a n ] A (@ ( @ A (A ( 8 <@ u s e r i n t f . h t m # S t a n d a l o n e C ) @ i f t r u e ( a n d N e w t P a c k i s i n s t a l l e d ) , b o o k i n c l u d e s a d d i t i o n a l ~ 2 5 K o f c o d e / o b j e c t s f o r o v e r v i e w a n d b a c k b u t t o n s , a n d s i m p l e n a v i g a t i o n s o t h a t N e w t ' s C a p e i s n o t r e q u i r e d . ( a l t e r n a t i v e l y , l e a v e o f f a n d s u p p l y N e w t ' s C a p e L i t e ) . C @ ,@ s t a r t [ i n t e g e r ] C a `@ s t r i n g i n d e x . d e f a u l t : l o c a t i o n o f < H T M L > C @ .@ s u b j e c t [ s t r i n g ] C ! @ f o r m a i l t o : , e m a i l S u b j e c t : . ( d e f a u l t : T I T L E o f c u r r e n t d o c u m e n t ? ) C i 1 q 4@ t h r e s h o l d [ i n t e g e r ] A $@ ( @ A A (A i $ 8 ,@ u s e r i n t f . h t m # B W C R@ d e f a u l t : 1 2 8 . n u m b e r b e t w e e n 1 - 2 5 4 C i ) a q 4@ t r u s t H T M L [ b o o l e a n ] A $@ ( @ A (A $ 8 <@ u s e r i n t f . h t m # t r u s t C a c h e C @ d e f a u l t : t r u e ( w h e t h e r t o " t r u s t t h e c a c h e " , i . e . , q u e r y s e r v e r a b o u t r e c e n c y o f e a c h c a c h e d e n t r y ) C i A a q 8@ t r u s t I m a g e s [ b o o l e a n ] A ,@ ( @ A q (A , 8 C (@ d e f a u l t : t r u e C @ ) 6@ : g e t U R L ( U R L , o p t i o n s ) @ g e t U R L C a @ R e t r i e v e s a n d p r o c e s s e s a d o c u m e n t f o r a h t t p : U R L f r o m c a c h e o r f r o m t h e i n t e r n e t . i t i m m e d i a t e l y r e t u r n s . C a @ &@ U R L [ s t r i n g ] @ U R L C @ u r l s t r i n g o r a r r a y ( i f a r r a y , p r o c e s s e s f i r s t ; q u e u e s r e s t ) C Y @ "@ " a n y t y p e " C @ i f a n a p p l i c a t i o n i s r e g i s t e r e d f o r a p r o t o c o l w i t h u r l C o p , : g e t U R L i s r e - s e n t . i f n o t . . . C q @ $@ h t t p ( H T M L ) @ h t t p U R L C i q @ d e f a u l t : N e w t ' s C a p e p a r s e s a n d d i s p l a y s d o c u m e n t . s e e i n s t a l l H T M L A p p f o r a l t e r n a t e p r o c e s s i n g o f H T M L t a g s a n d v a l u e s . i f o p t i o n s c o n t a i n s d a t a a n d m e t h o d , t h i s U R L e n c o d e s d a t a a n d s u b m i t s t o t h e s e r v e r . $A 8 A (A F 8 < 0 ` C @ <@ h t t p ( o t h e r M I M E t y p e s ) C i Y y q @ d e f a u l t : N e w t ' s C a p e d i s p l a y s G I F s , J P E G s a n d p l a i n t e x t , a n d i n s t a l l s p a c k a g e s . s e e i n s t a l l H e l p e r A p p f o r a l t e r n a t e p r o c e s s i n g o f f i l e s . $A T @ A (A E T @ ` x C @ @ m a i l t o : @ m a i l t o U R L C I f@ p o s t s m e s s a g e t o O u t b o x u s i n g c u r r e n t m a i l t r a n s p o r t . i f o p t i o n s c o n t a i n s d a t a a n d m e t h o d ( a n d s u b j e c t ) , t h i s U R L e n c o d e s d a t a i n a n e m a i l m e s s a g e ( h a n d y f o r l o c a l t e s t i n g ) . C @ @ n e w s : @ n e w s U R L C T@ i n v o k e s N e w t ' s P a p e r ( i f i n s t a l l e d ) C i q :@ o p t i o n s [ f r a m e o r n i l ] A @ < @ A (A ) 8 @ # o p t i o n s C a @ H e r e ' s a n e x a m p l e o f i n v o k i n g N e w t ' s C a p e " i n v i s i b l y " f o r a U R L , r e c h e c k i n g t h a t d o c u m e n t i s c u r r e n t ( a n d n o t r e t r i e v i n g o t h e r w i s e ) , n o t d i s p l a y i n g a n y N I E o r N e w t ' s C a p e s t a t u s , c a c h i n g t h e H T M L d o c u m e n t , o r c o n v e r t i n g a n d c a c h i n g t h e G I F i m a g e : C y @ G e t R o o t ( ) . | N e w t s C a p e : N e w t s C a p e | : g e t U R L (
" h t t p : / / w w w . . . . . " ,
{ c a c h e H T M L : " H T M L C a c h e : N e w t s C a p e " ,
c a c h e I m a g e s : " I m a g e C a c h e : N e w t s C a p e " ,
t r u s t H T M L : n i l ,
t r u s t I m a g e s : n i l ,
c a c h e O n l y : t r u e ,
h e l p e r A p p : {
a d d F i l e : f u n c ( t y p e , h r e f , c o n t e n t , o p t i o n s )
b e g i n
/ * y o u r c h a n c e t o d o s o m e t h i n g ( e x t r a c t U R L s , e t c . )
t y p e = M I M E t y p e ( s t r i n g )
h r e f = U R L ( s t r i n g )
c o n t e n t = s t r i n g o r V B O
o p t i o n s = t h e o p t i o n s f r a m e
* /
P r i n t ( t y p e ) ; P r i n t ( h r e f ) ; P r i n t ( c o n t e n t ) ;
i f S t r E q u a l ( t y p e , " i m a g e / g i f " ) a n d n o t i s F r a m e ( c o n t e n t )
t h e n b e g i n / * c o n v e r t t o a b i t m a p u s i n g u s e r p r e f s ( f o r g r a y , a n i m a t i o n ) * /
G e t R o o t ( ) . | N e w t s C a p e : N e w t s C a p e | : c o n v e r t I m a g e ( t y p e , h r e f , c o n t e n t , o p t i o n s , n i l ) ;
e n d ;
r e t u r n T R U E ; / * t h i s " h a n d l e d " i t * /
e n d } ,
I n e t S t a t u s : n i l ,
n o S t a t u s : t r u e ,
} )
C @ :@ : f e t c h U R L ( U R L , o p t i o n s ) @ f e t c h U R L C i ) q @ R e t r i e v e s a d o c u m e n t f o r a h t t p : U R L a n d r e t u r n t h e f i l e . S i n c e ( l i k e : g e t U R L ) t h i s r e t u r n s i m m e d i a t e l y , t h e s o u r c e i s p a s s e d t o y o u r a p p l i c a t i o n a s y n c h r o n o u s l y v i a a c a l l b a c k , a s s u m i n g t h a t y o u h a v e s p e c i f i e d a h e l p e r A p p o p t i o n . 4A $ A A (A i P 0 ` @ # g e t U R L (A P $ $ "@ # h e l p e r A p p C i ! A q &@ U R L [ s t r i n g ] A @ $ @ A Q (A y T 8 @ # U R L C i q ,@ o p t i o n s [ f r a m e ] A @ @ A (A ) 8 C Q F@ b e s u r e t o s p e c i f y h e l p e r A p p C ± &@ F o r e x a m p l e , C n@ G e t R o o t ( ) . | N e w t s c a p e : N e w t s c a p e | : f e t c h U R L ( " h t t p : / / x y z . c o m / f o o . h t m " ,
{ h e l p e r A p p : {
a d d F i l e : f u n c ( c o n t e n t T y p e , U R L , c o n t e n t , o p t i o n s )
b e g i n P r i n t ( c o n t e n t ) ; T R U E ; e n d ,
} ,
} ) C y @ N o t e : t h e r e i s n o d i f f e r e n c e b e t w e e n : g e t U R L a n d : f e t c h U R L - - f e t c h U R L i s p r o v i d e d s o l e l y f o r c o m p a t i b i l i t y w i t h t h e u r l C o p s p e c i f i c a t i o n , a n d p o s s i b l y a s a r e m i n d e r t h a t s o u r c e i s b e i n g " r e t u r n e d " . C 1 @ Ɖ T@ : i n s t a l l H T M L A p p ( a p p S y m b o l , h t m l A p p ) *@ i n s t a l l H T M L A p p C @ 2@ a p p S y m b o l [ s y m b o l ] C ! h@ u n i q u e i d e n t i f i e r f o r t h i s a p p l i c a t i o n / v i e w e r C ǡ @ :@ h t m l A p p [ f r a m e o r n i l ] C @ @ n i l C ) N@ d e - i n s t a l l h t m l A p p f o r a p p S y m b o l C ȑ @ ȩ @ f r a m e @ h t m l A p p C @ i n s t a l l s h t m l A p p a s a v i e w e r / b r o w s e r - - t h i s i s a c c e s s i b l e b y u s e r f r o m t h e P r o c e s s m e n u u n t i l n e x t r e b o o t ( o r d e - i n s t a l l ) . C @ j@ i t e m [ s t r i n g ] ( r e q u i r e d f o r i n s t a l l e d v e r s i o n ) C ʉ N@ n a m e t o a p p e a r i n P r o c e s s p i c k e r C @ Y d@ a d d H T M L i t e m ( t a g , s t a t u s ) [ m e t h o d ] ( o p t i o n a l ) $@ a d d H T M L i t e m C ˙ j@ d e f a u l t d e f i n i t i o n : ( s u p p l i e d b y N e w t ' s C a p e ) : C ! @ a d d H T M L i t e m : f u n c ( t a g , s t a t u s )
b e g i n
/ * W r i t e ( " t a g : " ) ; P r i n t ( t a g . _ t a g ) ;
W r i t e ( " v a l : " ) ; P r i n t ( t a g . _ v a l u e ) ;
P r i n t ( s t a t u s ) ; * /
/ * d i s p a t c h o n a n y t a g s t h a t a r e d e f i n e d * /
l o c a l t a g 1 : = t a g . _ t a g ;
i f H a s V a r i a b l e ( s e l f , t a g 1 )
t h e n P e r f o r m ( s e l f , t a g 1 , t a g ) ;
e n d C Q @ $@ t a g [ f r a m e ] C Α @ @ _ t a g C @@ [ s y m b o l ] i s f i r s t e l e m e n t C @ @ _ v a l u e C Q @ [ b o o l e a n , s t r i n g o r a r r a y ] t h e v a l u e , d e p e n d i n g o n t h e t y p e o f t a g C @ @ t r u e C 1 &@ t a g s t a r t i n g C q @ @ a r r a y C С @ e n t i r e t a g w i t h v a l u e a s a l t e r n a t i n g " s t y l e " t a g [ a r r a y ] , v a l u e [ s t r i n g ] C Q @ @ s t r i n g C щ L@ e n t i r e t a g w i t h v a l u e a s s t r i n g C @ @ n i l C ! "@ t a g e n d i n g C a @ 2@ ( o t h e r a t t r i b u t e s ) C ұ @ s t r i n g C @ *@ s t a t u s [ f r a m e ] C 1 8@ c u r r e n t l y , t h e o n l y i n t e r e s t i n g / d o c u m e n t e d s l o t i s b y t e s S o F a r [ i n t ] , w h i c h i n d i c a t e s c u r r e n t p a r s e r l o c a t i o n . t h i s c o u l d b e u s e d t o d i s p l a y p r o g r e s s . C ԁ @ $@ t a g m e t h o d s C @ i m p l e m e n t a m e t h o d f o r e a c h t a g y o u w a n t t o p r o c e s s , e . g . , H T M L : f u n c ( t a g ) . . . C Ձ @ 4@ o t h e r s l o t s , m e t h o d s C ,@ p r o v i d e a n y o t h e r i n t e r n a l s l o t s , m e t h o d s t o s h a r e c o d e a n d u p d a t e s t a t e . N e w t ' s C a p e u s e s h t m l A p p a s a _ p r o t o t o s u p p o r t r u n - t i m e m o d i f i c a t i o n s C i ! i ١ q B@ T o m a k e p e r s i s t e n t , c r e a t e a n a u t o p a r t p l u g i n w i t h N e w t D e v E n v o r N T K ( u s e a d e l a y e d a c t i o n i n y o u r I n s t a l l S c r i p t , o r c o n t a c t u s a b o u t h o w t o r e g i s t e r m o r e d i r e c t l y w i t h o u t i n s t a l l H T M L A p p ) . E x a m p l e : h t m l a p p i . h t m . T o p r o v i d e p r o g r a m m a t i c a l l y , e . g . , v i a : g e t U R L , s u p p l y h t m l A p p o p t i o n . 4A 0 A ٹ (A 0 , 4@ . . / e x s / h t m l a p p i . h t m (A A , P *@ # h t m l A p p O p t i o n C ډ @ r@ : i n s t a l l H e l p e r A p p ( c o n t e n t T y p e , a p p S y m b o l , h e l p e r A p p ) .@ i n s t a l l H e l p e r A p p C I @ ہ 6@ c o n t e n t T y p e [ s t r i n g ] $@ c o n t e n t T y p e C b@ t h e h t t p m e d i a / M I M E t y p e , e . g . , t e x t / p l a i n C A @ 2@ a p p S y m b o l [ s y m b o l ] C ܑ @ i d e n t i f i e r f o r t h i s a p p l i c a t i o n ( u n i q u e f o r t h i s c o n t e n t T y p e ) C 1 @ >@ h e l p e r A p p [ f r a m e o r n i l ] C ݉ @ @ n i l C ݹ j@ d e - i n s t a l l ( u n r e g i s t e r ) c o n t e n t T y p e , a p p S y m b o l C A @ Y @ f r a m e @ h e l p e r A p p C ޑ @@ i n s t a l l h e l p e r A p p a s a h e l p e r a p p f o r t h i s c o n t e n t t y p e ( a n d o p t i o n a l l y , s p e c i f i c f i l e e x t e n s i o n s ) ; h e l p e r A p p p e r s i s t s u n t i l n e x t r e b o o t ( o r d e - i n s t a l l ) . C @ H@ e x t e n s i o n s [ a r r a y ] ( o p t i o n a l ) C I @ i f s l o t i s s p e c i f i e d a n d a r r a y i s n o n - e m p t y , p r o c e s s o n l y t h o s e f i l e s w i t h m a t c h i n g f i l e e x t e n s i o n s , e . g . , . t x t . C Q @ @ a d d F i l e ( c o n t e n t T y p e , U R L , c o n t e n t , o p t i o n s ) [ m e t h o d ] ( r e q u i r e d * ) @ a d d F i l e C i Q q q 6@ c o n t e n t T y p e [ s t r i n g ] A ,@ $ @ A (A , $ 8 &@ # c o n t e n t T y p e C @ 4@ U R L [ s t r i n g o r n i l ] C 9 &@ t h e f i l e n a m e C y @ P@ c o n t e n t [ s t r i n g o r b i n a r y o b j e c t ] @ c o n t e n t C .@ t e x t / d a t a / " f i l e " C i Q q :@ o p t i o n s [ f r a m e o r n i l ] A @ < @ A (A ) 8 C @ p r o c e s s t h e c o n t e n t " f i l e " . r e t u r n N I L i f f i l e n o t p r o c e s s e d ( N e w t ' s C a p e w i l l t r y a n o t h e r h e l p e r A p p ) ; o t h e r w i s e , r e t u r n t r u e ( n o n - n i l ) C 9 \@ * N o t e : i f G e t R o o t ( ) . ( a p p S y m b o l ) i s a n a p p l i c a t i o n t h a t d e f i n e s a d d F i l e d i r e c t l y , t h e h e l p e r A p p f r a m e c a n o m i t a d d F i l e , a n d e v e n b e e m p t y { } i f t h e r e a r e n o e x t e n s i o n s . C i A q J@ T o m a k e p e r s i s t e n t , c r e a t e a n a u t o p a r t p l u g i n w i t h N e w t D e v E n v o r N T K ( u s e a d e l a y e d a c t i o n i n y o u r I n s t a l l S c r i p t , o r c o n t a c t u s a b o u t h o w t o r e g i s t e r m o r e d i r e c t l y w i t h o u t i n s t a l l H e l p e r A p p ) . E x a m p l e : h e l p a p p i . h t m . T o p r o v i d e p r o g r a m m a t i c a l l y , e . g . , v i a : g e t U R L , s u p p l y h e l p e r A p p o p t i o n . 4A 0 $ A Y (A 0 4@ . . / e x s / h e l p a p p i . h t m (A 4 $ P .@ # h e l p e r A p p O p t i o n C ) @ p@ : d i s p a t c h F i l e ( c o n t e n t T y p e , u r l , c o n t e n t , o p t i o n s ) &@ d i s p a t c h F i l e C @ T h i s i s a g e n e r i c d i s p a t c h m e t h o d f o r h e l p e r A p p . G e n e r a l l y , y o u r a p p l i c a t i o n w o u l d u s e : g e t U R L a s t h e m a i n A P I . H o w e v e r , d i s p a t c h F i l e s h o u l d b e u s e f u l f o r i n i t i a l t e s t i n g ( t o s k i p i n s t a l l H e l p e r A p p a n d a c t u a l h t t p f i l e t r a n s f e r s t e p s ) a n d a l s o t o r e p l a c e p a r s e H T M L . C i Q q q 6@ c o n t e n t T y p e [ s t r i n g ] A ,@ $ @ A (A , $ 8 C i ! q 4@ u r l [ s t r i n g o r n i l ] A @ @ @ A 1 (A y < 8 C i y q B@ c o n t e n t [ s t r i n g o r b i n a r y ] A @ L @ A (A 8 @ # c o n t e n t C i Y q :@ o p t i o n s [ f r a m e o r n i l ] A @ < @ A (A ) 8 C @ a X@ : G e t N a m e d R e s o u r c e ( s r c , n a m e s , v a l u e s ) .@ G e t N a m e d R e s o u r c e C @ p r o v i d e s m o r e f l e x i b i l i t y t h a n G e t P i c t A s B i t s o r G e t S o u n d f o r s o u p - b a s e d U R L s . C i @ &@ s r c [ s t r i n g ] C 8@ s o u p N a m e / r e s o u r c e N a m e C @ (@ n a m e s [ a r r a y ] C 9 4@ a r r a y o f n a m e s l o t s C @ *@ v a l u e s [ a r r a y ] C 6@ a r r a y o f v a l u e s l o t s C ! x@ F o r e x a m p l e , : G e t P i c t A s B i t s ( s r c ) i s e q u i v a l e n t t o : G e t N a m e d R e s o u r c e ( s r c , ' [ n a m e , t i t l e ] , ' [ b i t m a p , i c o n ] ) ; : G e t S o u n d ( s r c ) i s e q u i v a l e n t t o : G e t N a m e d R e s o u r c e ( s r c , ' [ n a m e ] , ' [ s o u n d ] ) . C @ 4@ : G e t P i c t A s B i t s ( s r c ) (@ G e t P i c t A s B i t s C ) @ r e t u r n s a g r a p h i c ( f o r U R L , a c o n v e r t e d G I F o r J P E G ; f o r s o u p e n t r y , b i t m a p o r P I C T ) C @ &@ s r c [ s t r i n g ] C 9 x@ a r e f e r e n c e f o r a g r a p h i c , i n o n e o f s e v e r a l f o r m a t s : C @ @ U R L C @ a b s o l u t e ( o r r e l a t i v e t o c u r r e n t b o o k ) u r l f o r a g r a p h i c ( i n c a c h e ) C @ 6@ s o u p N a m e / g r a p h i c N a m e C ,@ g r a p h i c f r o m a s o u p e n t r y ( f r o m b i t m a p o r i c o n s l o t ) , w h o s e i n d e x e d n a m e ( a s y m b o l o r s t r i n g ) m a t c h e s g r a p h i c N a m e . t y p i c a l l y c r e a t e d v i a S l o u p . C A @ q *@ : G e t S o u n d ( s r c ) @ G e t S o u n d C @ r e t u r n s a s o u n d f r o m a s o u p e n t r y ( t y p i c a l l y c r e a t e d v i a S l o u p ) C Q @ &@ s r c [ s t r i n g ] C 2@ s o u p N a m e / s o u n d N a m e C @ F o r e x a m p l e ,
< M E T A N A M E = " D A T A . s o u n d 1 " C O N T E N T = " : G e t S o u n d ( & q u o t ; s o u n d s / f o o . s n d & q u o t ; ) " >
< M E T A N A M E = " D A T A . p l a y s o u n d 1 " C O N T E N T = " f u n c ( x 1 , y 1 , h r e f , i t e m ) P l a y S o u n d ( s o u n d 1 ) " >
. . .
< A H R E F = " p l a y s o u n d 1 " > p l a y t h e s o u n d < / A > C A (@ F o r M o r e I n f o @ C r e d i t s C i Q q q 6@ " T o p : t h i s d o c u m e n t A H A (A H $ 0 @ # T o p C i ) I q B@ " N e x t : C h a r a c t e r E n t i t i e s A ` A Y (A ` $ $ 0 ,@ c h a r e n t . h t m # T o p C i q &@ " T O C : I n t r o A ( A ) (A Q ( $ 0 .@ i n t r o t o c . h t m # T O C C i q (@ " I n d e x : t a g s A , A (A ! , $ 0 2@ t a g i n d e x . h t m # I n d e x C i y q <@ " N e w t ' s C a p e H o m e P a g e A T A (A T $ 0 @ h t t p : / / m e m b e r s . b e l l a t l a n t i c . n e t / ~ s w e y e r / n e w t o n / n e w t s c a p e . h t m C @ T h i s d o c u m e n t ( i n a l l i t s f o r m a t s ) i s 1 9 9 7 - 9 9 . S t e v e W e y e r , G r e g S i m o n . A l l R i g h t s R e s e r v e d W o r l d w i d e C T@ V e r s i o n 2 . 0 . L a s t u p d a t e d : F e b 1 9 9 9 C I a A 1 q @ URtype @ URZrform C y A @ URf"C_proto @ UR KviewFormat C i q q @ S t e v e W e y e r - w e y e r @ k a g i . c o m
G r e g S i m o n - g r e g @ a c c e s s c o m . c o m ,A 8 8 8 H A (A 8 8 ( x 8 8@ m a i l t o : w e y e r @ k a g i . c o m (A A H 8 p @@ m a i l t o : g r e g @ a c c e s s c o m . c o m A C A ! @ URLz@\list @ C o n t e n t s A ! Y 9 q
Q
1 i I
)
a
A C A @ URw>bounds @ URCitem @ URazǸlevel A 0 C 9 A T C q A 4 C A P C A ( ` C $ A d C Q $9 A C ' A C * A C - A p C
1 / A C
i 2 A $ h C
4 A 0 t C
6 A p C 9 A C I ? A L C N A < C O A C U9 A C ) [A A T C a a9 A 0 t C A 0 t C A $ h C
A H C
A q A | C
y A x C
A C
A C ! ) A C Y A A C Q A @ UR 97nColumns @ UR column A C ! 0 A 9 1 @ URS6width ,A C A 1@ I(~o (~ *o {|}~;_ ${|~ B $A i ! 9 a ! @ UR҃hrefScriptG @ URUhasVariable (C i ,A
a y
A @ URYu!Cobj C
q @ URxFviewClickScript C @ I" C 9 q A
Y @ UR=arg C
q $@ UR;viewSetupDoneScript C 1 @ I({o ({A A i ! 9 a @ URļ"BookOpenScript C Q q A
A C
q @ UR)ZviewQuitScript C A =@ I()o { @_ 0{ o { _ "o /{ *_ 0" 0A i ! 9 Y ! @ URv-Copperfield $@ URQj4SetStatusBarButtons @ UR*d]hasVar !@ URClearKeyCommands @ UR(qlbuttonsOn @ URG7G[extraButtons @ UR?h stepChildren @ URƐRemoveSlot C a A
@ UR viewer C
q A C 1 d9 A @ URIpageSize @ URopages C Q A q @ UR+left @ UR.top @ URǢright @ URۡbottom A i q i 9 #Y %i ( *Q +1 ,i .9 0 3 6 9 =! ? A DA G IA I J Lq O) Q U W Z [Y ] `y b C A @ URJ0|template @ URNblocks 4A ! Y Y 9 C ! 9 A A C ! q 1 A l C ! a A C ! A C ! A , d C ! Q A d C @A 9 q Q 1 C ! I A 0 h C ! Q A h C ! Q A C ! A C ! A @ x C ! A x C ! 1 A | C ! i Q A C ! A < C ! 1 A C ! A l C ! I ! A l C q A l C ! &a > A C ! & ?Q A $ \ C ! & ? A \ C ! ' @ A d C ! 'A A9 A C ! 'y B A < C ! ' B A D t C ! ' C A | C (! 4A (Y ( ( ) )9 )q ) ) * i C ! (q Da A 0 ` C ! ( E A h C ! ( E A C ! ) F A 0 C ! )Q J A H C ! ) L) A C ! ) Lq A C ! ) M A C ! *1 M A C *i A * * * C ! * O1 A 0 C ! * Pa A C + U A C +I A +i + + ,1 C + + A 0 C U C ! + YI A 8 C ! , [ A C ! ,I _ A C , ,A I , , -! -Y - - . C ! , a A < C ! - di A X C ! -9 eY A C ! -q e A H C ! - f A H C ! - h A @ ( ` C ! . hA A @ ` C .Q 8A . . . /1 /i / / 0 0I 0 0 C ! . h A @ 0 h C ! . i) A @ h ( C ! / jq A H C ! /I ka A p C ! / l A C ! / m A ( C ! / m A H C ! 0) n A C ! 0a o! A C ! 0 oa A h C ! 0 p1 A C 1 8A 1A 1y 1 1 2! 2Y 2 2 3 39 3q C ! 1Y q! A 0 C ! 1 q A C ! 1 r A C ! 2 s A 0 C ! 29 t A 0 C ! 2q u A H C ! 2 vA A H x C ! 2 v A C ! 3 w A C ! 3Q w A X C 3 x 4 A X C 3 0A 3 4I 4 4 4 5) 5a 5 5 C 4 41 8 A 0 C x1 C ! 4a y A C ! 4 z A C ! 4 {! A C ! 5 | A C ! 5A | A C ! 5y }9 A C ! 5 ~i A C ! 5 ~ A < C 6! HA 6i 6 6 7 7I 7 7 7 8) 8a 8 8 9 9A 9y C ! 6 A @ 0 h C ! 6 9 A @ h C ! 6 A @ C ! 7) A @ P C ! 7a A @ p C ! 7 A C ! 7 ! A @ 8 C ! 8 Q A @ 8 h C ! 8A A @ C ! 8y 9 A C ! 8 ! A 8 C ! 8 A X C ! 9! y A C ! 9Y A C ! 9 A x C 9 DA : :I : : : ;) ;a ; ; < 1 >i > > ? ?I C = = D A 0 C C ! = A C ! > A C ! >I A , C ! > A , C ! > ) A D C ! > q A D 4 C ! ?) A T C ?a 1 A C ? 0A ? @! @Y @ @ A A9 Aq A C ? @ d A 0 P C I C ! @9 Y A l C ! @q 9 A C ! @ A , C ! @ A , C ! A y A C ! AQ i A C ! A A $ \ C A D A \ C A 0A B) B B B C) Ca C C D C BI Bi H \ A 0 P C C ! B Y A l C ! B Y A C ! C ! A $ \ C ! CA A \ | C ! Cy A C ! C I A C ! C A $ \ C ! D! A \ C DY