"winsound" --- Διεπαφή αναπαραγωγής ήχου για Windows
****************************************************

**Source code:** PC/winsound.c

======================================================================

The "winsound" module provides access to the basic sound-playing
machinery provided by Windows platforms.  It includes functions and
several constants.

Διαθεσιμότητα: Windows.


Functions
=========

winsound.Beep(frequency, duration)

   Εκπέμπει ηχητικό σήμα από το ηχείο του υπολογιστή. Η παράμετρος
   *frequency* καθορίζει τη συχνότητα, σε hertz, του ήχου και πρέπει
   να είναι στο εύρος 37 έως 32.767. Η παράμετρος *duration* καθορίζει
   τον αριθμό των χιλιοστών του δευτερολέπτου που θα διαρκέσει ο ήχος.
   Εάν το σύστημα δεν μπορεί να κάνει ηχητικό σήμα στο ηχείο, γίνεται
   raise μια "RuntimeError".

winsound.PlaySound(sound, flags)

   Καλεί την υποκείμενη συνάρτηση "PlaySound()" από το API της
   πλατφόρμας. Η παράμετρος *sound* μπορεί να είναι ένα όνομα αρχείου,
   ένα ψευδώνυμο συστήματος ήχου, δεδομένα ήχου ως *bytes-like
   object*, ή "None". Η ερμηνεία της εξαρτάται από την τιμή των
   *flags*, τα οποία μπορούν να είναι ένας bitwise ORed συνδυασμός των
   σταθερών που περιγράφονται παρακάτω. Εάν η παράμετρος *sound* είναι
   "None", οποιοσδήποτε ήχος κύματος που παίζει αυτή τη στιγμή
   σταματά. Εάν το σύστημα υποδεικνύει σφάλμα, κάνει raise μια
   εξαίρεση "RuntimeError".

winsound.MessageBeep(type=MB_OK)

   Καλεί την υποκείμενη συνάρτηση "MessageBeep()" από το API της
   πλατφόρμας. Αυτό αναπαράγει έναν ήχο όπως καθορίζεται στο μητρώο.
   Το όρισμα *type* καθορίζει ποιος ήχος θα αναπαραχθεί. Οι δυνατές
   τιμές είναι "-1", "MB_ICONASTERISK", "MB_ICONEXCLAMATION",
   "MB_ICONHAND", "MB_ICONQUESTION" και "MB_OK", όλες περιγράφονται
   παρακάτω. Η τιμή "-1" παράγει ένα "απλό ηχητικό σήμα". Αυτό είναι
   το τελικό εφεδρικό αν δεν μπορεί να αναπαραχθεί άλλος ήχος. Εάν το
   σύστημα υποδεικνύει σφάλμα, γίνεται raise μια "RuntimeError".


Constants
=========

winsound.SND_FILENAME

   The *sound* παράμετρος είναι το όνομα ενός αρχείου WAV. Μην το
   χρησιμοποιείτε με "SND_ALIAS".

winsound.SND_ALIAS

   Η παράμετρος *sound* είναι ένα όνομα συσχέτισης ήχου από το μητρώο.
   Εάν το μητρώο δεν περιέχει τέτοιο όνομα, αναπαράγει τον
   προεπιλεγμένο ήχο του συστήματος, εκτός εάν έχει καθοριστεί επίσης
   "SND_NODEFAULT". Εάν δεν είναι εγγεγραμμένος κανένας προεπιλεγμένος
   ήχος, γίνεται raise μια "RuntimeError". Μην το χρησιμοποιείτε με
   "SND_FILENAME".

   Όλα τα συστήματα Win32 υποστηρίζουν τουλάχιστον τα παρακάτω. Τα
   περισσότερα συστήματα υποστηρίζουν πολύ περισσότερα:

   +----------------------------+------------------------------------------+
   | "PlaySound()" *name*       | Αντίστοιχο όνομα ήχου στον Πίνακα        |
   |                            | Ελέγχου                                  |
   |============================|==========================================|
   | "'SystemAsterisk'"         | Αστερίσκος                               |
   +----------------------------+------------------------------------------+
   | "'SystemExclamation'"      | Αναφώνηση                                |
   +----------------------------+------------------------------------------+
   | "'SystemExit'"             | Έξοδος από τα Windows                    |
   +----------------------------+------------------------------------------+
   | "'SystemHand'"             | Κρίσιμη Διακοπή                          |
   +----------------------------+------------------------------------------+
   | "'SystemQuestion'"         | Ερώτηση                                  |
   +----------------------------+------------------------------------------+

   Για παράδειγμα:

      import winsound
      # Play Windows exit sound.
      winsound.PlaySound("SystemExit", winsound.SND_ALIAS)

      # Probably play Windows default sound, if any is registered (because
      # "*" probably isn't the registered name of any sound).
      winsound.PlaySound("*", winsound.SND_ALIAS)

winsound.SND_LOOP

   Αναπαράγει τον ήχο επανειλημμένα. Η σημαία "SND_ASYNC" πρέπει
   επίσης να χρησιμοποιηθεί για να αποφευχθεί το μπλοκάρισμα. Δεν
   μπορεί να χρησιμοποιηθεί με "SND_MEMORY".

winsound.SND_MEMORY

   The *sound* παράμετρος της "PlaySound()" είναι μια εικόνα μνήμης
   ενός αρχείου WAV, ως *bytes-like object*.

   Σημείωση:

     Αυτό το module δεν υποστηρίζει την αναπαραγωγή από μια εικόνα
     μνήμης ασύγχρονα, οπότε ένας συνδυασμός αυτής της σημαίας και της
     "SND_ASYNC" θα εγείρει "RuntimeError".

winsound.SND_PURGE

   Σταματά την αναπαραγωγή όλων των περιπτώσεων του καθορισμένου ήχου.

   Σημείωση:

     Αυτή η σημαία δεν υποστηρίζεται σε σύγχρονες πλατφόρμες Windows.

winsound.SND_ASYNC

   Επιστρέφει άμεσα, επιτρέποντας στους ήχους να αναπαράγονται
   ασύγχρονα.

winsound.SND_NODEFAULT

   Εάν ο καθορισμένος ήχος δεν μπορεί να βρεθεί, μην αναπαράγετε τον
   προεπιλεγμένο ήχο του συστήματος.

winsound.SND_NOSTOP

   Μην διακόπτετε τους ήχους που παίζουν αυτή τη στιγμή.

winsound.SND_NOWAIT

   Επιστρέφει άμεσα εάν ο οδηγός ήχου είναι απασχολημένος.

   Σημείωση:

     Αυτή η σημαία δεν υποστηρίζεται σε σύγχρονες πλατφόρμες Windows.

winsound.SND_APPLICATION

   Η παράμετρος *sound* είναι ένα ψευδώνυμο συγκεκριμένης εφαρμογής
   στο μητρώο. Αυτή η σημαία μπορεί να συνδυαστεί με τη σημαία
   "SND_ALIAS" για να καθορίσει ένα ψευδώνυμο ήχου που ορίζεται από
   την εφαρμογή.

winsound.SND_SENTRY

   Πυροδοτεί ένα γεγονός SoundSentry όταν αναπαράγεται ο ήχος.

   Added in version 3.14.

winsound.SND_SYNC

   Ο ήχος αναπαράγεται συγχρονισμένα. Αυτή είναι η προεπιλεγμένη
   συμπεριφορά.

   Added in version 3.14.

winsound.SND_SYSTEM

   Αναθέτει τον ήχο στην συνεδρία ήχου για ήχους ειδοποίησης
   συστήματος.

   Added in version 3.14.

winsound.MB_ICONASTERISK

   Αναπαράγει τον ήχο "SystemDefault".

winsound.MB_ICONEXCLAMATION

   Αναπαράγει τον ήχο "SystemExclamation".

winsound.MB_ICONHAND

   Αναπαράγει τον ήχο "SystemHand".

winsound.MB_ICONQUESTION

   Αναπαράγει τον ήχο "SystemQuestion".

winsound.MB_OK

   Αναπαράγει τον ήχο "SystemDefault".

winsound.MB_ICONERROR

   Αναπαράγει τον ήχο "SystemHand".

   Added in version 3.14.

winsound.MB_ICONINFORMATION

   Αναπαράγει τον ήχο "SystemDefault".

   Added in version 3.14.

winsound.MB_ICONSTOP

   Αναπαράγει τον ήχο "SystemHand".

   Added in version 3.14.

winsound.MB_ICONWARNING

   Αναπαράγει τον ήχο "SystemExclamation".

   Added in version 3.14.
