Initial re-upload of spice2x-24-08-24

external/stepmaniax-sdk/sdk/Windows/SMXPanelAnimationUpload.h

@@ -0,0 +1,39 @@
+#ifndef SMXPanelAnimationUpload_h
+#define SMXPanelAnimationUpload_h
+
+#include "SMXPanelAnimation.h"
+
+// For SMX_API:
+#include "../SMX.h"
+
+// This is used to upload panel animations to the firmware.  This is
+// only needed for offline animations.  For live animations, either
+// use SMX_LightsAnimation_SetAuto, or to control lights directly
+// (recommended), use SMX_SetLights.  animations[] contains the animations
+// to load.
+//
+// Prepare the currently loaded animations to be stored on the pad.
+// Return false with an error message on error.
+//
+// All LightTypes must be loaded before beginning the upload.
+//
+// If a lights upload is already in progress, returns an error.
+SMX_API bool SMX_LightsUpload_PrepareUpload(int pad, SMX_LightsType type, const SMXPanelAnimation animations[9], const char **error);
+
+typedef void SMX_LightsUploadCallback(int progress, void *pUser);
+
+// After a successful call to SMX_LightsUpload_PrepareUpload, begin uploading data
+// to the master controller for the given pad and animation type.
+//
+// The callback will be called as the upload progresses, with progress values
+// from 0-100.
+//
+// callback will always be called exactly once with a progress value of 100.
+// Once the 100% progress is called, the callback won't be accessed, so the
+// caller can safely clean up.  This will happen even if the pad disconnects
+// partway through the upload.
+//
+// The callback will be called from the user callback helper thread.
+SMX_API void SMX_LightsUpload_BeginUpload(int pad, SMX_LightsUploadCallback callback, void *pUser);
+
+#endif