update naming

Author: yunline

buildconfig/stubs/pygame/mixer.pyi

@@ -83,7 +83,7 @@ class Channel:
     def unpause(self) -> None: ...
     def fadeout(self, time: int) -> None: ...
     def queue(self, sound: Sound) -> None: ...
-    def set_position(self, angle:int, distance:int) -> None: ...
+    def set_source_location(self, angle:int, distance:int) -> None: ...
     @overload
     def set_volume(self, value: float) -> None: ...
     @overload

docs/reST/ref/mixer.rst

@@ -480,10 +480,10 @@ change the default buffer by calling :func:`pygame.mixer.pre_init` before
 
       .. ## Channel.fadeout ##
 
-   .. method:: set_position
+   .. method:: set_source_location
 
       | :sl:`set the position of a playing channel`
-      | :sg:`set_volume(angle,distance) -> None`
+      | :sg:`set_source_location(angle,distance) -> None`
 
       Set the position (angle, distance) of a playing channel.
 
@@ -493,7 +493,7 @@ change the default buffer by calling :func:`pygame.mixer.pre_init` before
 
       .. versionadded:: 2.3.0
 
-      .. ## Channel.set_position ##
+      .. ## Channel.set_source_location ##
 
    .. method:: set_volume
 

src_c/doc/mixer_doc.h

@@ -29,7 +29,7 @@
 #define DOC_MIXER_CHANNEL_PAUSE "pause() -> None\ntemporarily stop playback of a channel"
 #define DOC_MIXER_CHANNEL_UNPAUSE "unpause() -> None\nresume pause playback of a channel"
 #define DOC_MIXER_CHANNEL_FADEOUT "fadeout(time) -> None\nstop playback after fading channel out"
-#define DOC_MIXER_CHANNEL_SETPOSITION "set_volume(angle,distance) -> None\nset the position of a playing channel"
+#define DOC_MIXER_CHANNEL_SETSOURCELOCATION "set_source_location(angle,distance) -> None\nset the position of a playing channel"
 #define DOC_MIXER_CHANNEL_SETVOLUME "set_volume(value) -> None\nset_volume(left, right) -> None\nset the volume of a playing channel"
 #define DOC_MIXER_CHANNEL_GETVOLUME "get_volume() -> value\nget the volume of the playing channel"
 #define DOC_MIXER_CHANNEL_GETBUSY "get_busy() -> bool\ncheck if the channel is active"

src_c/mixer.c

@@ -1161,7 +1161,7 @@ chan_unpause(PyObject *self, PyObject *_null)
 }
 
 static PyObject *
-chan_set_position(PyObject *self, PyObject *args)
+chan_set_source_location(PyObject *self, PyObject *args)
 {
     int channelnum = pgChannel_AsInt(self);
     Sint16 angle;
@@ -1311,8 +1311,8 @@ static PyMethodDef channel_methods[] = {
     {"pause", (PyCFunction)chan_pause, METH_NOARGS, DOC_MIXER_CHANNEL_PAUSE},
     {"unpause", (PyCFunction)chan_unpause, METH_NOARGS,
      DOC_MIXER_CHANNEL_UNPAUSE},
-    {"set_position", chan_set_position, METH_VARARGS,
-     DOC_MIXER_CHANNEL_SETPOSITION},
+    {"set_source_location", chan_set_source_location, METH_VARARGS,
+     DOC_MIXER_CHANNEL_SETSOURCELOCATION},
     {"set_volume", chan_set_volume, METH_VARARGS, DOC_MIXER_CHANNEL_SETVOLUME},
     {"get_volume", (PyCFunction)chan_get_volume, METH_NOARGS,
      DOC_MIXER_CHANNEL_GETVOLUME},

test/mixer_test.py

@@ -911,13 +911,13 @@ def setUp(self):
         filename = example_path(os.path.join("data", "house_lo.mp3"))
         self.snd = mixer.Sound(filename)
 
-    def test_set_position(self):
-        prompt("Please wear earphones before the test for set_position() starts")
+    def test_set_source_location(self):
+        prompt("Please wear earphones before the test for set_source_location() starts")
         ch = self.snd.play()
         angle = 0
         distance = 100
         while ch.get_busy():
-            ch.set_position(angle, distance)
+            ch.set_source_location(angle, distance)
             angle += 1
             angle %= 360
             time.sleep(0.01)
@@ -929,7 +929,7 @@ def test_set_position(self):
         distance = 0
         direction = 0
         while ch.get_busy():
-            ch.set_position(angle, distance)
+            ch.set_source_location(angle, distance)
             if distance == 0 or distance == 255:
                 direction = 1 - direction
             distance += 1 if direction else -1