more resampler notes

docs/stb_resample_ideas.txt

@@ -71,8 +71,8 @@ the highest-level one could be:
 
 the lowest-level one could be:
 
-   stb_resample_arbitrary(void       *dest, stbr_type dest_type, int dest_width, int dest_height, int dest_stride_in_bytes,
-                          void const *src , stbr_type  src_type, int  src_width, int  src_height, int src_stride_in_bytes,
+   stb_resample_arbitrary(void       *dst, stbr_type dst_type, int dst_width, int dst_height, int dst_stride_in_bytes,
+                          void const *src, stbr_type src_type, int src_width, int src_height, int src_stride_in_bytes,
                           int channels,
                           int nonpremul_alpha_channel_index,
                           stbr_wrapmode wrap,                     // clamp, wrap, mirror
@@ -80,17 +80,11 @@ the lowest-level one could be:
                           float s0, float t0, float s1, float t1, // range of source to use, 0..1 in GPU texture-coordinate style
                           void  *tempmem, size_t tempmem_size_in_bytes);
 
-And there would be a bunch of convenience functions at in-between levels.
+And there would be a bunch of convenience functions in-between those two levels.
 
 
 Some notes:
 
-   Intermediate-level functions should be provided for each source type & same dest type
-   so that the code is typesafe; only when people fall back to stb_resample_arbitrary should
-   they be at risk for type unsafety. (One way to deal with the explosion of functions of
-   every possible type would be to define one function for each input type, and accept three
-   separate output pointers, one for each type, only one of which can be non-NULL.)
-
    nonpremul_alpha_channel_index:
        if this is negative, no channels are processed specially
        if this is non-negative, then it's the index of the alpha channel,
@@ -108,13 +102,36 @@ Some notes:
            images by computing "tiles" of images a bit at a time without forcing those
            tiles to quantize their source data.
 
-   tempmem, tempmem_size
+   tempmem, tempmem_size:
        all functions will needed tempmem, but they can allocate a fixed tempmem buffer
            on the stack. providing an API that allows overriding the amount of tempmem
            available allows people to process arbitrarily large images. the return
            value for the function could be 0 on success or non-0 being the size of
            tempmem needed.
    
+   src_stride, dest_stride:
+       the stride variables are signed to allow you to describe both traditional
+           top-to-bottom images (pass in a pointer to the top-left pixel and
+           a positive stride) and bottom-to-top images (pass in a pointer to
+           the bottom-left pixel and a negative stride)
+
+   ordering of src & dest:
+       put these in whatever order you like, i just chose one arbitrarily
+
+   width & height
+       these are ints not unsigned ints or size_ts because i personally forbid
+           unsigned variables for almost everything to avoid signed/unsigned comparison
+           issues, but this is a matter of personal taste and you can do differently
+
+   Intermediate-level functions should be provided for each source type & same dest type
+   so that the code is typesafe; only when people fall back to stb_resample_arbitrary should
+   they be at risk for type unsafety. (One way to deal avoid an explosion of functions of
+   every possible *combination* of types in a type-safe way would be to define one function
+   for each input type, and accept three separate output pointers, one for each type, only
+   one of which can be non-NULL. 9 functions isn't that bad, but if you want to have three
+   or four intermediate-level functions with fewer parameters, 9*4 gets silly. Could also
+   use the same trick for stb_resample_arbitrary, replacing it with three typesafe functions.)
+