Skip to content

Latest commit

 

History

History
107 lines (72 loc) · 5.18 KB

FEEDBACKS.md

File metadata and controls

107 lines (72 loc) · 5.18 KB
Raw

OSC Feedbacks

Feedbacks are the messages OSCPoint sends to your OSC client to tell you about the current state of PowerPoint. They are sent out of OSCPoint as OSC messages via UDP.

Note

Feedbacks starting with /oscpoint/v2/ are new in version 2.x of OSCPoint.

Valid at any time

  • /oscpoint/v2/event [string: eventType] [args]
    See EVENTS.md for a full list of events and arguments from this message.

  • /oscpoint/v2/presentations [string: JSON array of presentation objects]
    List of all presentations currently open in PowerPoint. Includes the name, path, slide count, and whether the presentation is saved and in slide show mode. Also includes a full list of the individual sections that make up the presentation.
    For an example of the JSON structure, see PRESENTATION.md.

  • /oscpoint/v2/presentation [string: JSON presentation object] The current presentation object. Includes the name, path, slide count, and whether the presentation is saved and in slide show mode. Also includes a full list of the individual sections that make up the presentation.
    If no presentation is open, this message include a blank presentation object:

    {"name":"","path":"","slideCount":0,"saved":false,"active":false,"slideshow":false,"sections":null}

  • /oscpoint/v2/files/path [string: path]
    The path to the OSCPoint folder, relative to the user's home directory. For more details about this feature, see FILES.md.

Valid whenever a presentation is open

Note: These feedbacks will switch values with focus changes if multiple presentations are open.

  • /oscpoint/presentation/name [string: presentationFileName]
    Current presentation filename.

  • /oscpoint/presentation/slides/count [integer: n]
    Total number of slides in presentation.

  • /oscpoint/slideshow/state [string stateName]
    The current state of the presentation. Possible values are: edit or slideshow

Valid only during a slide show

  • /oscpoint/slideshow/currentslide [integer: n]
    Current slide number (1-based).

  • /oscpoint/slideshow/builds/position [integer: n]
    The build position of the current slide.

  • /oscpoint/slideshow/builds/count [integer: n]
    The total number of builds on the current slide.

  • /oscpoint/slideshow/builds/remaining [integer: n]
    The number of builds remaining on the current slide.

  • /oscpoint/slideshow/section/index [integer: n]
    Current section index (1-based).

  • /oscpoint/slideshow/section/name [string: sectionName]
    Current section name.

  • /oscpoint/slideshow/notes [string: notesText]
    Current slide notes (ASCII encoding). Line breaks are normally sent as CR, ASCII 13 (0D in hex).

  • /oscpoint/slideshow/notes-utf8 [blob: notesText] v2.0.2+ required
    Current slide notes in UTF-8 encoding. This is sent as raw bytes and will need decoding by your OSC client.

Note

Use ASCII encoded notes for quick, easy reading.
Use UTF-8 encoded notes for full international character support, but you'll have to do the decoding yourself - or use the Companion Module, which does this for you.
To avoid busting UDP packet size limits, notes longer than 32,000 characters this will be truncated (that's a lot of notes).

Valid only during a slideshow, and when there's a media element on the current slide

Please also see the note about media in ACTIONS.md - all the same caveats apply here

These OSC messages will be emitted once every 500ms while the media is in the playing state.

  • /oscpoint/slideshow/media/state [string: stateName]
    The current state of the media element. Possible values are: playing, paused, stopped, notready

  • /oscpoint/slideshow/media/duration [integer: n]
    The total duration of the media clip in milliseconds.

  • /oscpoint/slideshow/media/durationtrimmed [integer: n] v2.1+ required
    The trimmed duration of the media clip in milliseconds (from the clip's start point to the clip's end point).
    This will be the same as the total duration if the media clip has not been trimmed.

  • /oscpoint/slideshow/media/startpoint [integer: n] v2.1+ required
    The start point of the media clip in milliseconds, measured from the start of the full clip.
    Will be 0 if the media clip has not been trimmed.

  • /oscpoint/slideshow/media/endpoint [integer: n] v2.1+ required
    The end point of the media clip in milliseconds, measured from the start of the full clip.
    Will be the same as the total duration if the media clip has not been trimmed.

  • /oscpoint/slideshow/media/position [integer: n]
    The current position of the media playhead in milliseconds, measured from the start point.

  • /oscpoint/slideshow/media/remaining [integer: n]
    The remaining playtime of the media in milliseconds.

Note

Media feedbacks do not currently (as of add-in v2.0.x) report correctly if a media file has been trimmed in PowerPoint. They will report the full duration of the media file, not the trimmed duration. This is a known issue and will be addressed in a future release.