Skip to content

Commit 3bfd994

Browse files
committed
general: Fix a couple of misformatted docstrings.
1 parent c52db72 commit 3bfd994

File tree

2 files changed

+38
-27
lines changed

2 files changed

+38
-27
lines changed

panda/src/audio/audioSound.h

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -42,17 +42,23 @@ class EXPCL_PANDA_AUDIO AudioSound : public TypedReferenceCount {
4242
virtual void set_loop_count(unsigned long loop_count=1) = 0;
4343
virtual unsigned long get_loop_count() const = 0;
4444

45-
/*
46-
* Control time position within the sound. This is similar (in concept) to
47-
* the seek position within a file. time in seconds: 0 = beginning; length()
48-
* = end. inits to 0.0. - The current time position will not change while the
49-
* sound is playing; you must call play() again to effect the change. To play
50-
* the same sound from a time offset a second time, explicitly set the time
51-
* position again. When looping, the second and later loops will start from
52-
* the beginning of the sound. - If a sound is playing, calling get_time()
53-
* repeatedly will return different results over time. e.g.: PN_stdfloat
54-
* percent_complete = s.get_time() s.length();
55-
*/
45+
/**
46+
* Control time position within the sound, in seconds. This is similar (in
47+
* concept) to the seek position within a file. The value starts at 0.0 (the
48+
* default) and ends at the value given by the length() method.
49+
*
50+
* The current time position will not change while the sound is playing; you
51+
* must call play() again to effect the change. To play the same sound from
52+
* a time offset a second time, explicitly set the time position again. When
53+
* looping, the second and later loops will start from the beginning of the
54+
* sound.
55+
*
56+
* If a sound is playing, calling get_time() repeatedly will return different
57+
* results over time. e.g.
58+
* @code
59+
* PN_stdfloat percent_complete = s.get_time() / s.length();
60+
* @endcode
61+
*/
5662
virtual void set_time(PN_stdfloat start_time=0.0) = 0;
5763
virtual PN_stdfloat get_time() const = 0;
5864

panda/src/putil/bamEnums.h

Lines changed: 21 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,13 @@
2222
*/
2323
class EXPCL_PANDA_PUTIL BamEnums {
2424
PUBLISHED:
25-
26-
// This defines an enumerated type used to represent the endianness of
27-
// certain numeric values stored in a Bam file. It really has only two
28-
// possible values, either BE_bigendian or BE_littleendian; but through a
29-
// preprocessor trick we also add BE_native, which is the same numerically
30-
// as whichever value the hardware supports natively.
25+
/**
26+
* This defines an enumerated type used to represent the endianness of
27+
* certain numeric values stored in a Bam file. It really has only two
28+
* possible values, either BE_bigendian or BE_littleendian; but through a
29+
* preprocessor trick we also add BE_native, which is the same numerically
30+
* as whichever value the hardware supports natively.
31+
*/
3132
enum BamEndian {
3233
BE_bigendian = 0,
3334
BE_littleendian = 1,
@@ -38,21 +39,25 @@ class EXPCL_PANDA_PUTIL BamEnums {
3839
#endif
3940
};
4041

41-
/*
42-
* This is the code written along with each object. It is used to control
43-
* object scoping. A BOC_push includes an object definition, and will always
44-
* be eventually paired with a BOC_pop (which does not). A BOC_adjunct
45-
* includes an object definition but does not push the level; it is associated
46-
* with the current level. BOC_remove lists object ID's that have been
47-
* deallocated on the sender end. BOC_file_data may appear at any level and
48-
* indicates the following datagram contains auxiliary file data that may be
49-
* referenced by a later object.
50-
*/
42+
/**
43+
* This is the code written along with each object. It is used to control
44+
* object scoping.
45+
*/
5146
enum BamObjectCode {
47+
// Indicates an object definition, and will always be eventually paired
48+
// with a BOC_pop (which does not).
5249
BOC_push,
5350
BOC_pop,
51+
52+
// Includes an object definition but does not push the level; it is
53+
// associated with the current level.
5454
BOC_adjunct,
55+
56+
// Lists object IDs that have been deallocated on the sender end.
5557
BOC_remove,
58+
59+
// May appear at any level and indicates the following datagram contains
60+
// auxiliary file data that may be referenced by a later object.
5661
BOC_file_data,
5762
};
5863

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy