updated hackersguide:

* added some small pieces
* incorporated some former READMEs and Mike's fabulous demuxer and decoder doc
* splitted into multiple files
* made new drawings (hopefully I am not the only one to understand them)
* Makefile support for building a HTML version which is now
  installed in the user's doc directory

CVS patchset: 5494
CVS date: 2003/10/12 19:06:43

1 files changed, 304 insertions, 0 deletions

diff --git a/doc/hackersguide/library.fig b/doc/hackersguide/library.fig
new file mode 100644
index 000000000..893ff363e
--- /dev/null
+++ b/doc/hackersguide/library.fig
@@ -0,0 +1,304 @@
+#FIG 3.2
+Landscape
+Center
+Metric
+A4      
+100.00
+Single
+-2
+1200 2
+6 900 405 1350 855
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 900 450 1080 450 1080 855
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 1170 855 1170 450 1350 450
+-6
+6 1890 7470 3330 7965
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 1890 7470 3330 7470 3330 7965 1890 7965 1890 7470
+4 0 0 50 0 20 11 0.0000 4 135 885 2205 7740 xine_stream_t\001
+-6
+6 3330 7335 4365 8055
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 3330 7695 3510 7335 4185 7335 4365 7695 4185 8055 3510 8055
+	 3330 7695
+4 0 0 50 0 20 11 0.0000 4 150 930 3420 7740 xine_post_wire\001
+-6
+6 3915 6210 7335 8235
+6 4770 6705 5220 7155
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 4770 6750 4950 6750 4950 7155
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 5040 7155 5040 6750 5220 6750
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 4635 7425 5445 7425 5445 7155
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 4635 7155 7065 7155 7065 8235 4635 8235 4635 7155
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
+	 4635 8235 4365 8235 4365 7155 4635 7155
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
+	 7065 8235 7335 8235 7335 7155 7065 7155
+4 0 0 50 0 20 11 0.0000 4 150 1785 3915 6570 xine_list_post_plugins_typed\001
+4 0 0 50 0 20 11 0.0000 4 150 1365 3915 6345 xine_list_post_plugins\001
+4 0 0 50 0 20 11 0.0000 4 150 1155 5265 6795 xine_post_dispose\001
+4 0 0 50 0 20 11 0.0000 4 150 720 4680 7335 xine_post_t\001
+4 0 0 50 0 20 11 0.0000 4 150 855 3915 6795 xine_post_init\001
+4 0 0 50 0 20 11 1.5708 4 150 900 4545 8100 xine_post_in_t\001
+4 0 0 50 0 20 11 1.5708 4 150 990 7245 8145 xine_post_out_t\001
+4 0 0 50 0 20 11 0.0000 4 150 1065 6075 7875 xine_post_output\001
+4 0 0 50 0 20 11 0.0000 4 150 1395 4680 7875 xine_post_list_outputs\001
+4 0 0 50 0 20 11 0.0000 4 150 1305 4680 7650 xine_post_list_inputs\001
+4 0 0 50 0 20 11 0.0000 4 150 975 6075 7650 xine_post_input\001
+-6
+6 7335 7335 8370 8055
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 7335 7695 7515 7335 8190 7335 8370 7695 8190 8055 7515 8055
+	 7335 7695
+4 0 0 50 0 20 11 0.0000 4 150 930 7425 7740 xine_post_wire\001
+-6
+6 8370 7425 9630 7920
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 8390 7438 9630 7438 9630 7920 8390 7920 8390 7438
+4 0 0 50 0 20 11 0.0000 4 150 720 8705 7708 xine_post_t\001
+-6
+6 9630 7335 11520 8055
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 9630 7695 9810 7335 11340 7335 11520 7695 11340 8055 9810 8055
+	 9630 7695
+4 0 0 50 0 20 11 0.0000 4 150 1650 9765 7740 xine_post_wire_video_port\001
+-6
+6 11520 7425 12780 7920
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 11540 7438 12780 7438 12780 7920 11540 7920 11540 7438
+4 0 0 50 0 20 11 0.0000 4 150 1095 11655 7708 xine_video_port_t\001
+-6
+6 2250 5580 2970 7470
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 2610 7470 2250 7290 2250 5760 2610 5580 2970 5760 2970 7290
+	 2610 7470
+4 0 0 50 0 20 11 1.5708 4 135 1680 2655 7335 xine_stream_master_slave\001
+-6
+6 10215 2565 13635 4005
+6 11655 2790 12105 3240
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 11655 2835 11835 2835 11835 3240
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 11925 3240 11925 2835 12105 2835
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 11520 3510 12690 3510 12690 3240
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 11520 3240 13590 3240 13590 4005 11520 4005 11520 3240
+4 0 0 50 0 20 11 0.0000 4 150 1890 10215 2700 xine_list_video_output_plugins\001
+4 0 0 50 0 20 11 0.0000 4 135 1485 12150 2880 xine_close_video_driver\001
+4 0 0 50 0 20 11 0.0000 4 150 1455 10215 2880 xine_open_video_driver\001
+4 0 0 50 0 20 11 0.0000 4 150 1095 11565 3420 xine_video_port_t\001
+4 0 0 50 0 20 11 0.0000 4 150 1545 11655 3780 xine_port_send_gui_data\001
+-6
+6 9630 4995 11520 5715
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 9630 5355 9810 4995 11340 4995 11520 5355 11340 5715 9810 5715
+	 9630 5355
+4 0 0 50 0 20 11 0.0000 4 150 1650 9765 5400 xine_post_wire_audio_port\001
+-6
+6 8370 5085 9630 5580
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 8390 5098 9630 5098 9630 5580 8390 5580 8390 5098
+4 0 0 50 0 20 11 0.0000 4 150 720 8705 5368 xine_post_t\001
+-6
+6 10215 4185 13635 5625
+6 11655 4410 12105 4860
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 11655 4455 11835 4455 11835 4860
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 11925 4860 11925 4455 12105 4455
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 11520 5130 12690 5130 12690 4860
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 11520 4860 13590 4860 13590 5625 11520 5625 11520 4860
+4 0 0 50 0 20 11 0.0000 4 150 1890 10215 4320 xine_list_audio_output_plugins\001
+4 0 0 50 0 20 11 0.0000 4 135 1485 12150 4500 xine_close_audio_driver\001
+4 0 0 50 0 20 11 0.0000 4 150 1455 10215 4500 xine_open_audio_driver\001
+4 0 0 50 0 20 11 0.0000 4 150 1095 11565 5040 xine_audio_port_t\001
+-6
+6 945 3060 7290 5580
+6 2025 3105 2475 3555
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 2025 3150 2205 3150 2205 3555
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 2295 3555 2295 3150 2475 3150
+-6
+6 7020 3555 7290 5580
+6 7065 3555 7245 4545
+4 0 0 50 0 20 11 1.5708 4 150 990 7200 4545 xine_post_out_t\001
+-6
+6 7065 4545 7245 5535
+4 0 0 50 0 20 11 1.5708 4 150 990 7200 5535 xine_post_out_t\001
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 2
+	 7020 4590 7290 4590
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 4
+	 7020 5580 7290 5580 7290 3555 7020 3555
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 1890 3825 2835 3825 2835 3555
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 1890 3555 7020 3555 7020 5580 1890 5580 1890 3555
+4 0 0 50 0 20 11 0.0000 4 150 885 3015 4545 xine_get_error\001
+4 0 0 50 0 20 11 0.0000 4 150 990 3015 4770 xine_get_status\001
+4 0 0 50 0 20 11 0.0000 4 150 1275 3015 4995 xine_get_pos_length\001
+4 0 0 50 0 20 11 0.0000 4 150 1260 3015 5220 xine_get_audio_lang\001
+4 0 0 50 0 20 11 0.0000 4 150 1155 3015 5445 xine_get_spu_lang\001
+4 0 0 50 0 20 11 0.0000 4 150 630 2115 4095 xine_open\001
+4 0 0 50 0 20 11 0.0000 4 150 585 2115 4320 xine_play\001
+4 0 0 50 0 20 11 0.0000 4 150 600 2115 4545 xine_stop\001
+4 0 0 50 0 20 11 0.0000 4 135 660 2115 4770 xine_close\001
+4 0 0 50 0 20 11 0.0000 4 150 630 2115 4995 xine_eject\001
+4 0 0 50 0 20 11 0.0000 4 150 990 3015 4095 xine_set_param\001
+4 0 0 50 0 20 11 0.0000 4 150 990 3015 4320 xine_get_param\001
+4 0 0 50 0 20 11 0.0000 4 150 1320 2520 3195 xine_stream_dispose\001
+4 0 0 50 0 20 11 0.0000 4 135 885 1935 3735 xine_stream_t\001
+4 0 0 50 0 20 11 0.0000 4 135 1095 945 3195 xine_stream_new\001
+4 0 0 50 0 20 11 0.0000 4 150 1470 5535 4095 xine_get_current_frame\001
+4 0 0 50 0 20 11 0.0000 4 150 1380 5535 4320 xine_get_current_vpts\001
+4 0 0 50 0 20 11 0.0000 4 135 1020 5535 4545 xine_trick_mode\001
+4 0 0 50 0 20 11 0.0000 4 150 1425 5535 4995 xine_get_audio_source\001
+4 0 0 50 0 20 11 0.0000 4 150 1425 5535 5220 xine_get_video_source\001
+4 0 0 50 0 20 11 0.0000 4 150 1335 4185 4095 xine_get_stream_info\001
+4 0 0 50 0 20 11 0.0000 4 150 1215 4185 4320 xine_get_meta_info\001
+-6
+6 945 1260 2430 1890
+4 0 0 50 0 20 11 0.0000 4 135 510 945 1395 xine_init\001
+4 0 0 50 0 20 11 0.0000 4 150 1470 945 1620 xine_engine_set_param\001
+4 0 0 50 0 20 11 0.0000 4 150 1470 945 1845 xine_engine_get_param\001
+-6
+6 8280 1260 10035 2340
+4 0 0 50 0 20 11 0.0000 4 150 1725 8280 1395 xine_get_log_section_count\001
+4 0 0 50 0 20 11 0.0000 4 150 1275 8280 1620 xine_get_log_names\001
+4 0 0 50 0 20 11 0.0000 4 150 510 8280 1845 xine_log\001
+4 0 0 50 0 20 11 0.0000 4 150 780 8280 2070 xine_get_log\001
+4 0 0 50 0 20 11 0.0000 4 150 1275 8280 2295 xine_register_log_cb\001
+-6
+6 5850 1260 8055 2790
+4 0 0 50 0 20 11 0.0000 4 150 1395 5850 1395 xine_get_browse_mrls\001
+4 0 0 50 0 20 11 0.0000 4 150 2190 5850 1620 xine_get_autoplay_input_plugin_ids\001
+4 0 0 50 0 20 11 0.0000 4 150 1470 5850 1845 xine_get_autoplay_mrls\001
+4 0 0 50 0 20 11 0.0000 4 150 1530 5850 2070 xine_get_file_extensions\001
+4 0 0 50 0 20 11 0.0000 4 150 1365 5850 2295 xine_get_mime_types\001
+4 0 0 50 0 20 11 0.0000 4 150 2025 5850 2520 xine_get_demux_for_mime_type\001
+4 0 0 50 0 20 11 0.0000 4 150 2085 5850 2745 xine_get_input_plugin_description\001
+-6
+6 3960 1260 5670 2340
+4 0 0 50 0 20 11 0.0000 4 150 1380 3960 1395 xine_config_register_*\001
+4 0 0 50 0 20 11 0.0000 4 150 1680 3960 1620 xine_config_get_first_entry\001
+4 0 0 50 0 20 11 0.0000 4 150 1710 3960 1845 xine_config_get_next_entry\001
+4 0 0 50 0 20 11 0.0000 4 150 1575 3960 2070 xine_config_lookup_entry\001
+4 0 0 50 0 20 11 0.0000 4 150 1590 3960 2295 xine_config_update_entry\001
+-6
+6 2655 1260 3780 1890
+4 0 0 50 0 20 11 0.0000 4 150 1035 2655 1395 xine_config_load\001
+4 0 0 50 0 20 11 0.0000 4 150 1080 2655 1620 xine_config_save\001
+4 0 0 50 0 20 11 0.0000 4 150 1095 2655 1845 xine_config_reset\001
+-6
+6 2655 9630 6345 12150
+6 4005 9675 4455 10125
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 4005 9720 4185 9720 4185 10125
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 4275 10125 4275 9720 4455 9720
+-6
+6 3825 10485 6255 11295
+6 4725 10575 5175 11025
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 4725 10620 4905 10620 4905 11025
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 4995 11025 4995 10620 5175 10620
+-6
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 4455 11025 5445 11025 5445 11295 4455 11295 4455 11025
+4 0 0 50 0 20 11 0.0000 4 135 795 4590 11205 xine_event_t\001
+4 0 0 50 0 20 11 0.0000 4 135 990 5265 10665 xine_event_free\001
+4 0 0 50 0 20 11 0.0000 4 150 945 3825 10620 xine_event_get\001
+4 0 0 50 0 20 11 0.0000 4 135 1005 3825 10755 xine_event_wait\001
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 3690 10395 5085 10395 5085 10125
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 3690 10125 6345 10125 6345 11700 3690 11700 3690 10125
+4 0 0 50 0 20 11 0.0000 4 150 1455 2655 9765 xine_event_new_queue\001
+4 0 0 50 0 20 11 0.0000 4 150 1680 4545 9765 xine_event_dispose_queue\001
+4 0 0 50 0 20 11 0.0000 4 150 1245 3780 10305 xine_event_queue_t\001
+4 0 0 50 0 20 11 0.0000 4 135 2130 3825 11565 xine_event_create_listener_thread\001
+4 0 0 50 0 20 11 0.0000 4 135 1050 2655 12105 xine_event_send\001
+-6
+6 7380 9630 11340 11700
+6 8235 9675 8685 10125
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 8235 9720 8415 9720 8415 10125
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 3
+	0 0 1.00 60.00 120.00
+	 8505 10125 8505 9720 8685 9720
+-6
+6 8055 10485 9540 11565
+4 0 0 50 0 20 11 0.0000 4 135 1065 8055 10620 xine_osd_draw_*\001
+4 0 0 50 0 20 11 0.0000 4 150 1470 8055 10845 xine_osd_get_text_size\001
+4 0 0 50 0 20 11 0.0000 4 135 1140 8055 11070 xine_osd_set_font\001
+4 0 0 50 0 20 11 0.0000 4 150 1455 8055 11295 xine_osd_set_encoding\001
+4 0 0 50 0 20 11 0.0000 4 150 1380 8055 11520 xine_osd_set_position\001
+-6
+6 9585 10260 11250 11565
+4 0 0 50 0 20 11 0.0000 4 135 960 9585 10395 xine_osd_show\001
+4 0 0 50 0 20 11 0.0000 4 135 885 9585 10620 xine_osd_hide\001
+4 0 0 50 0 20 11 0.0000 4 135 930 9585 10845 xine_osd_clear\001
+4 0 0 50 0 20 11 0.0000 4 150 1635 9585 11070 xine_osd_set_text_palette\001
+4 0 0 50 0 20 11 0.0000 4 150 1320 9585 11295 xine_osd_get_palette\001
+4 0 0 50 0 20 11 0.0000 4 150 1320 9585 11520 xine_osd_set_palette\001
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 7920 10395 8775 10395 8775 10125
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 7920 10125 11340 10125 11340 11700 7920 11700 7920 10125
+4 0 0 50 0 20 11 0.0000 4 135 870 8775 9765 xine_osd_free\001
+4 0 0 50 0 20 11 0.0000 4 135 675 8010 10305 xine_osd_t\001
+4 0 0 50 0 20 11 0.0000 4 135 885 7380 9765 xine_osd_new\001
+-6
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 765 1125 1350 1125 1350 855
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 765 855 14085 855 14085 8595 765 8595 765 855
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 7290 3780 7470 3420 11340 3420 11520 3780 11340 4140 7470 4140
+	 7290 3780
+2 3 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 7
+	 7290 5355 7470 4995 8190 4995 8370 5355 8190 5715 7470 5715
+	 7290 5355
+2 1 2 1 0 7 50 0 -1 3.000 0 0 -1 0 0 2
+	 2520 9000 1890 7470
+2 1 2 1 0 7 50 0 -1 3.000 0 0 -1 0 0 2
+	 1890 7965 2520 12510
+2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 3
+	 2520 9270 3555 9270 3555 9000
+2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
+	 2520 9000 11745 9000 11745 12510 2520 12510 2520 9000
+4 0 0 50 0 20 11 0.0000 4 135 375 855 1035 xine_t\001
+4 0 0 50 0 20 11 0.0000 4 135 555 1395 495 xine_exit\001
+4 0 0 50 0 20 11 0.0000 4 135 585 315 495 xine_new\001
+4 0 0 50 0 20 11 0.0000 4 135 1155 2790 495 xine_health_check\001
+4 0 0 50 0 20 11 0.0000 4 135 885 2610 9180 xine_stream_t\001